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The Systems Plus Approach. 

For the dealer, assurance of personal service and a full range 
of dealer support services, including seminars, comprehensive 
collateral material, and highly skilled technical personnel. At Systems 
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About The Cover 

This issue’s cover is an en¬ 
hanced version of an “apostolic” page 
from the fabulous Book of Kells, an 
Irish illuminated manuscript of the 
9th Century. This book is on display 
in Dublin in two seperate locations. 
The Books of Matthew and Mark are 
in the Georgian reading library above 
the book store on Trinity College 
Campus, and the books of Luke and 
John are on display at the National 
Museum a few blocks from Trinity. 

The Book of Kells contains pig¬ 
ments imported from Syria and Af¬ 
ghanistan long before Marco Polo 
was said to have opened the trade to 
the Orient. The blue is lapis lazuli, 
and the ochre and yellow pigments 
are found only in the area around Je¬ 
rusalem. These pigments indicate 
that 8th Century Irish monks con¬ 
ducted trade with the holy land, prob¬ 
ably by sea. 

This title page is an illustration 
of John, the author of the book of 
Revelations. The Book of Kells, like 
the Lindisfarne Gospels and many 
other dark age illuminated manu¬ 
scripts, are loaded with submerged 
codes. The keys to deciphering these 
codes are found in the front of the 
book in a section called the Canon 
(much like a computer program 
heading). This is usually a section 
which enables the reader to read the 
texts in differential order to arrive at 
different meaning or a clarification. 

This same technique was car¬ 
ried out in the Kabballah, and in 
many pre-Christian Gnostic texts 
such as the book of Jubalies and the 
Enochion. In this sense they operated 
very much like user's guides to the 
culture and its religions. 

H.H. 
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Editorial... 


A New Magazine For Computer Users 

Covering CP/M Systems and Software 


How can these things be? 

— The Gospel According to St. John 3:9 


This issue is the first of a new kind of magazine, and a 
new medium for documentation of the highest quality. 

The User's Guide may be the only magazine in the 
computing, or in any consumer interest, that offers detailed 
lengthy tutorials (sometimes over twenty pages) on using 
specific products. And in computing, there is such a need for 
good documentation! 

We chose to focus on CP/M systems because there are 
so many different computers that run CP/M. As CP/M pro¬ 
liferates (over 500,000 systems now operating), there is a po¬ 
tential for something unique to occur in the computer 
industry: people who are not programmers may begin to un¬ 
derstand CP/M, and thereby know how to use many differ¬ 
ent computers at the same time, rather than know only one 
specific system. 

The immense popularity of CP/M (every “mass mar¬ 
ket” personal computer now runs CP/M, as well as nearly ev¬ 
ery business desktop computer system) is due largely to its 
familiar set of commands and application programs. 

CP/M has been called the “Rosetta Stone” and the 
“Holy Grail” of microcomputing. For beginners, a knowl¬ 
edge of CP/M suddenly unlocks the mysteries of the comput¬ 
er and makes available a library of “holy texts” (distinctive 
application programs). Newcomers become “enlightened” to 
the magic of using a computer in a variety of applications. 

To programmers, CP/M provides the “Rosetta Stone” 
key to using several different languages to write a variety of 
different applications, all in different styles. To system pack¬ 
agers, CP/M offers the capability to include, within one 
modern desktop computer system, a mix of proven programs 
from older and larger systems. 

CP/M is really a software medium to allow standard 
application programs to run on a variety of different comput¬ 
ers. As an “operating system” (its technical name), it is fair, 
not so friendly as hoped, but simple and versatile. 

As a medium for software exchange, it is excellent. Im¬ 
portant also is its ability to function as a medium for data ex¬ 
change. People who use computers for word processing first 
discovered the advantage of having a CP/M system: the abil¬ 
ity to transmit “files” (collections of data, such as a chapter 
of a book) to other, almost completely different systems, and 
use the files on those systems. As magazine writers and pro¬ 
ducers, we recognized the advantage of having our electronic 
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library stored in the CP/M format. We can write and edit ar¬ 
ticles electronically, and transmit them to a typesetting ser¬ 
vice, without ever printing them on paper. We can also use 
our files on other CP/M systems. Why not cover CP/M? It is 
the system of choice for us, and for many other writers and 
publishers. 

Like the Book of Kells Canon, this first issue provides a 
CP/M tutorial that acts as a key to decipher future issues. 
This issue introduces the world of CP/M and some of its ter¬ 
minology, and lays a foundation with useful habits and tips 
on preventive maintenance. 

The issue also introduces one activity that is gaining in 
importance with users: data communications. CompuServe 
is a service you can call by phone and use with your home or 
office computer. Such information services will soon provide 
electronic banking, “tele-shopping,” reservations by comput¬ 
er, research data bases, etc. They may revolutionize the way 
we bank, shop, plan trips and do business. 

In future issues we intend to cover typical personal 
computer applications such as word processing, financial 
modeling and forecasting, preparing taxes, performing mul¬ 
tiple printing and mailing list operations, and managing a 
data base. 

We want to provide the best documentation in the 
industry, on a timely basis that covers the best software as 
soon as it is available. 

We want readers to know they can always reach for 
The User's Guide when they need to know how to use a 
CP/M system or an application program. We want subscrib¬ 
ers to learn as much as possible over the next few years, to 
become more knowledgeable about their investment in com¬ 
puting tools. We are proving that such computing tools are 
useful in producing this magazine and in servicing our sub¬ 
scribers and advertisers. 

The User's Guide will provide articles that show you 
how to use personal computers in interesting and useful ap¬ 
plications. You need not know anything about computers to 
gain useful knowledge about computing from this publica¬ 
tion. We’d like to answer your questions, and point the way 
for you to solve your problems, for one thing is certain: this 
industry has a long way to go before it can make computers 
that can explain themselves. 0 
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For Starters... 


The World of CP/M 

A basic introduction to using small computers 



We promise to bring you, in ev¬ 
ery issue, at least one article for be¬ 
ginners that introduces the topic 
covered in that issue. In this issue, 
the topic is CP/M itself. 


This magazine is devoted to a 
type of system known as a “CP/M” 
system. What is a “CP/M?” It 
stands for Control Program for Mi¬ 
crocomputers, and it runs on many 
different brands of desktop and por¬ 
table computers. In fact, it is prob¬ 
ably the most widely used program in 
the world. 

CP/M was created by Gary 
Kildall, who later founded Digital 
Research to support it. Digital Re¬ 
search (Pacific Grove, CA) supplies 
CP/M to manufacturers and system 
packagers, who package the system 
with the computer hardware and pro¬ 
vide it to retailers. 

It is usually supplied with your 
system, in the form of a master floppy 
disk to be inserted in the disk drive of 
your computer. For example, Xerox 
provides CP/M for its 820 computer 
on a Xerox 820 disk in the box with 
the 820, and Osborne Computer 
Corp. provides CP/M on an Osborne 
disk in the box with the Osborne 01 


computer. 

Some computer manufacturers 
do not supply CP/M, but CP/M is 
available for their computers. Radio 
Shack does not sell CP/M on a disk 
for its computers, but at least four 
other software distributors sell it (you 
must buy the Radio Shack computer 
first). The Apple II computer re¬ 
quires an extra add-on circuit board 
to run CP/M, and Apple does not 
supply these products, but you can get 
the special add-on board with CP/M 
from distributors, and it is easy to in¬ 
stall. 


The CP/M Advantage 

CP/M is an operating system. 
(That doesn’t just mean that it works 
— it may not be “operating,” but it is 
an operating system). Essentially it is 
the first (or one of the first) pieces of 
“software” to gain control of the com¬ 
puter (the “hardware”). 
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You need such a thing, to get 
your computer working for you (rath¬ 
er than you working to program it). 
You need the system to be up and run¬ 
ning before you can start running a 
useful application program. 

Once you have CP/M, you can 
purchase additional programs that 
make your CP/M system a useful 
business or professional computer. 
Word processing, data base manage¬ 
ment, forecasting, budgeting and ac¬ 
counting programs are available for 
CP/M systems from many indepen¬ 
dent distributors. At last count there 
were over two thousand different ap¬ 
plication programs for CP/M sys¬ 
tems. Nearly every application 
thought up for desktop computers is 
possible with a CP/M-type computer 
and an off-the- shelf CP/M applica¬ 
tion program. 

The reason for this is simple: 
CP/M is a standard software system 
available to use with non-standard 
computers. Programs written for 
CP/M do not have to contain the ac¬ 
tual code to operate the system. One 
program can be written for a “stan¬ 
dard CP/M system” and then used in 
many different computers. 

Another major advantage to us¬ 
ing CP/M is the ability to transfer 
your data to a computer from a differ¬ 
ent manufacturer. Your business 
could purchase an IBM or Xerox 
computer running CP/M, and you 
could buy a portable Osborne com¬ 
puter running CP/M for use in your 
home or while traveling, and be able 
to exchange data between the differ¬ 
ent computers. 

It is helpful to remember that 
computers recognize two types of in¬ 
formation: program instructions and 
regular data. CP/M can store both 
kinds of information on the same 
disk, and the information is struc¬ 
tured into files that are universally 
recognized by other CP/M systems. 
It is therefore possible to transfer any 
file of data, or any program (file of 
program instructions), from one sys¬ 
tem to another system where they can 
also be used. 

CP/M systems can be pro¬ 
grammed in a variety of computer 
languages (FORTRAN, Pascal, CO¬ 
BOL, BASIC, Forth, APL, Ada, 
etc.). Popular programs like Word¬ 


Star, SpellGuard and SuperCalc 
were first introduced on CP/M sys¬ 
tems. Note, however, that some sys¬ 
tems hide CP/M from you — you 
never see it, you only see menu selec¬ 
tions on your screen to choose from. 

Although a CP/M application 
program will theoretically work in 
any CP/M system, most have to be 
slightly modified for specific display 
screens and printers. Most CP/M 
programs come equipped with instal¬ 
lation programs that perform this 
modification for you. You simply se¬ 
lect your specific display terminal or 
computer from the “menu” of selec¬ 
tions that appears on your screen. 

“CP/M compatibility” is all 
well and good, but can you actually 
transfer CP/M programs and data 
files to another computer? Over the 
phone, yes, or even directly through a 
cable, if you have the appropriate 
software on both systems (sometimes 
it has to be the same program on both 
systems). This is a topic to cover all 
by itself, and soon! 

Can I use my disk in another 
CP/M system? Not until you’ve read 
about the horrors of... 

The Disk Dilemma 

It would be easy to transfer data 
from one computer to another if both 
computers stored data in the same 
format on the ubiquitous floppy disk. 
However, we seem to have three types 
of disks: eight-inch (diameter), five- 
inch (actually five and a quarter), 
and the new three-inch disks. 

Unfortunately, formats used for 
five-inch and three-inch disk systems 
are usually proprietary to the manu¬ 
facturers. To buy software for your 
five-inch or three-inch disk system, 
the software must be supplied on the 
type of disk you are using and in the 
same format. 

Most eight-inch disk systems 
that run CP/M offer the ability to use 
the CP/M standard disk format: the 
eight-inch single-density single sided 
disk (also known as the IBM 3740 
format). If your data files are on 
CP/M single-density disks, you 
should be able to use those disks to 
transfer those files to another eight- 
inch disk CP/M system (the same 
disk should work in both systems). 

Most eight-inch disk systems 



also offer the option of using a propri¬ 
etary double-density format (twice as 
much data can fit in the same space). 
You should use the proprietary for¬ 
mat for your working disks (to have 
more space for working), but you 
should use the single-density stan¬ 
dard format for your archives. 

By the way, you should keep ar¬ 
chive disks. This is perhaps the most 
overlooked advantage to using com¬ 
puters: you can archive vast amounts 
of data on disk, and duplicate the 
disks (perhaps keeping the duplicates 
in a lead-lined safe), and thereby 
have a more secure and compact ar¬ 
chive than you could ever have with a 
paper system. We actually carry the 
contents of two books and four maga¬ 
zines on a few disks in a briefcase. 

Typical Small Computer 
System 

The newest small computers are 
complete desktop units that include a 
keyboard, display screen, and at least 
one floppy disk drive (usually two). A 
typical system has a printer and mo¬ 
dem device attached to it by special 
cables. The printer may also have a 
“tractor feed” device for feeding con¬ 
tinuous form paper. 

Users who need a lot of disk 
storage can add more expensive hard 
disk subsystems to provide more “on¬ 
line” storage (disk space available 
while using the system, without hav¬ 
ing to replace a cartridge or disk). 

Printers available with personal 
computers include the “letter qual¬ 
ity” daisy-wheel or thimble-wheel 
printers (such as the Diablo HyType 
or the NEC Spinwriter), or the less 
expensive “dot matrix” printers (such 
as the popular Epson MX-80 or Cen¬ 
tronics 747). 
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Modems are used for data com¬ 
munications over phone lines. Mo¬ 
dems come in two types: acoustic 
couplers that connect to your tele¬ 
phone handset, or direct-connect mo¬ 
dems that connect to the telephone 
line directly. 

What is inside the small com¬ 
puter? There is always a device called 
the CPU, for central processing unit , 
which is driven by the operating sys¬ 
tem and its programs. This chip (usu¬ 
ally from the Intel or Zilog family) is 
the traffic cop of the circuits, direct¬ 
ing the How of program instructions 
and data. 

There is also an area of circuitry 
known as internal memory. The com¬ 
puter can “see” only the amount of 
program instructions and data that 
can fit into this region of internal 
memory, known as RAM (random 
access memory, also known as really 
active memory). To “see” any more 
program instructions and data, the 
computer must replace the stuff al¬ 
ready in internal memory with new 
program instructions and data from 
your disks. 

Therefore, and this is really all 
you need to know about RAM, you 
can use only programs that can fit 
into the region of memory offered by 
your computer system. 

For example, if you have a “48 K 
system,” you cannot use a program 
that requires 56K of RAM. Most sys¬ 
tems offer 64K of RAM (the stan¬ 
dard amount for business and 
professional applications), because 
many CP/M application programs 
require more than 48K (the standard 
amount in many home computers). 

What is a “K?” You should also 
ask: what is a bytel A byte is a unit of 
measuring information. One letter, 
comma, space, period or other char¬ 
acter occupies one byte. This article, 
which is filled with letters, commas, 
periods, spaces and symbols, is ap¬ 
proximately 14336 bytes, or “14K” 
bytes. 

We use “K” for approximately 
1000 (actually 1024) bytes to esti¬ 
mate the various sizes of internal 
RAM or external disk memory: 

64K 64 kilobytes, a standard amount 

of internal memory, or RAM, in 

CP/M systems. 


256K 

256 kilobytes, a standard 
amount of floppy disk space on 
single- density, single sided (un¬ 
formatted) disks. Also, a large 
amount of RAM typical in 
large “16-bit” systems. 


5M 5 megabytes, or 5000 kilobytes, 
a standard amount of disk space 
in Winchester-type hard disk 
subsystems. 

You can add a hard disk subsys¬ 
tem to your personal computer to hold 
a large data base holding data such as 
inventory, accounting, or client re¬ 
cords. Most hard disks for personal 
computers are also known as “Win¬ 
chester-type disks” after the “Win¬ 
chester” technology developed by 
IBM. 

A professional writer could use 
a small computer with two floppy disk 
drives, a printer, and a modem to 
transfer data over telephone lines to 
and from other computers. The two 
floppy disk drives are more than ade¬ 
quate for word processing, budgeting, 
project planning and other personal 
business activities, which can be kept 
on separate sets of disks. 

Typical Applications 

For typical applications there 
are “off the shelf’ software packages. 
Such a package contains a program 
(or set of programs) that performs the 
application in a typical way. For ex¬ 
ample, programs to do accounting 
follow standard accounting principles 
and are acceptable for use by certi¬ 
fied public accountants. 

The most typical application so 
far has been word processing. Nearly 
everyone has some word processing to 
do — writing documents, memos, re¬ 
ports, letters, novels, etc. There are 
numerous word processing programs 
available for CP/M systems (such as 
WordStar, Magic Wand, Spellbinder, 
etc.). 

Another typical application is 
data communications. There are pro¬ 
grams to handle transfer of data to re¬ 
mote computers, to use information 
services like The Source or Compu¬ 
Serve, and to “talk” to “host” com¬ 
puters from your home or portable 


computer. The latter activity is typi¬ 
cal among corporate managers away 
from the office who need to communi¬ 
cate with their office computers. 

The most important overall ap¬ 
plication is data management. Com¬ 
puters can organize information into 
data bases that let you find a specific 
record with a simple command. How¬ 
ever, data base management pro¬ 
grams usually need to be tailor-made 
or adjusted for your data base appli¬ 
cation. 

Standard “off the shelf’ ac¬ 
counting and inventory data base pro¬ 
grams can be integrated within an 
overall management program, or sep¬ 
arated into “modules” for accounts 
receivable, accounts payable, payroll, 
etc. Data management programs usu¬ 
ally have “report generators,” or 
modules that print reports. These 
modules can be combined and altered 
to fit your application. 

A program useful for a general 
activity such as accounts payable 
may be incorporated into a more spe¬ 
cific overall program to handle a spe¬ 
cific application, such as medical 
patient billing. There are client-han¬ 
dling programs that are tailor-made 
for doctors, lawyers, tax accountants 
and even tailors. 

To shop for a computer, you 
should first shop for an application 
program suited to your application 
needs. This advice is summed up as 
“look for the software first, then the 
machine (hardware) to run the soft¬ 
ware you need.” 

CD 

This description provided a 
glimpse into this complicated world 
of floppy disks and computerese. 
Don’t be thrown by acronyms like 
PIP or terms like byte and backup. 
Every new technological achievement 
introduces new words to our vocabu¬ 
lary. You’ll pick up the acronyms and 
buzz words as you learn to use com¬ 
puters, and you may find yourself 
buzzing with excitement after a few 
days with a new computer. Remem¬ 
ber that for every computer phreak 
there must have been a first time, a 
stage that you are going through now: 
familiarizing yourself with personal 
computers and the world of CP/M. 

0 
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A Tutorial on CP/M-80 & CP/M-86... 


Learning To Use CP/M 



by Tony Bove & Cheryl Rhodes 


CP/M stands for “Control Program for Microcomputers.” It is a disk operat¬ 
ing system — a master control program that supervises all activities in a disk-based 
computer system. 

Although not as sophisticated as the Master Control Program in Walt Disney’s 
TRON , or as intelligent as HAL in Stanley Kubrick’s 2001 , CP/M appears on many 
different small computers as the master program that controls all other programs 
and computing efforts. 

All versions of CP/M start with the kernal created by Digital Research, Inc. 
(DRI). Most systems employ customized versions of CP/M, either modified by DRI 
or by the system manufacturer or packager. Many small computers for business and 
professional applications run a version of CP/M. 

Some introductory technical data , for those who need it: CP/M-80 (the 
“eight-bit” version) is offered for many different computers that are based on the 
Z80 microprocessor (Zilog) or based on the 8080 and 8085 processors (Intel). 
CP/M- 86 (the new “sixteen-bit” version) is offered for computers based on the 
8086 or 8088 microprocessors (Intel). Aversion for computers based on the Motor¬ 
ola 68000 (CP/M-68) is in the works and may be available at this time. Yes, this 
tutorial covers both CP/M-80 and CP/M-86 (sorry, not CP/M-68, not yet!). 

Although a computer can be programmed to do various things, to most people 
a computer is not useful unless it is already programmed to do useful things — that 
is, it must be supplied with an operating system and useful application programs, 
such as programs for accounting, word processing, budgeting and forecasting, data 
base management, etc. 

CP/M is a popular operating system because it has a large library of applica¬ 
tion programs. The primary use of CP/M is to control your computer in order to run 
these application programs. CP/M manages your use of them, and gives you the 
ability to run other programs as well as write and run your own. 

CP/M is supplied on one floppy disk, called the master system disk , along 
with utility programs provided with CP/M. The next section describes ordinary “va¬ 
nilla” CP/M as it appears on most computers. Differences in customized versions for 
popular computers are described in boxed sections accompanying this article. 
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Starting CP/M 

First, turn on any devices connected to your computer (including disk drives, 
printers, terminal, etc.), and then turn on the computer unit. 

Insert your system disk (either your master disk, or a backup copy of it) into 
drive A. Press the RESET button on your computer (some computers have a reset 
key on the keyboard, and some require a special key combination, such as SHIFT 
and RESET). The CP/M system should display a message, such as 64K CP/M or 
48K CP/M, possibly accompanied by a copyright notice and a version number. (This 
typeface is used to show screen messages.) 

The system should also display a prompt message: usually A) or OA). The 
prompt tells you what disk drive the system is currently using to look for all files (in¬ 
cluding programs). To see a list of the names of these files, type the command DIR 
and press your RETURN key. 


fcr NOTE: Your keyboard should have a key marked “RETURN” or “CR”, 
“ENTER”, or “NEW LINE”. If it doesn’t have one of these, ask your dealer 
which key is the RETURN or Carriage Return key. We use the P symbol in the 
following example to stand for the RETURN key. We also use THIS TYPEFACE to 
show words you type; and THIS TYPEFACE to show words displayed by the system. 


If you have two disk drives, find a suitable disk (one that already works with 
your system) to insert into the second drive, known as drive B. (If you don’t have a 
suitable disk, you will have to prepare one by formatting it — skip to the instructions 
on formatting a disk). 

With a disk in drive B, type the following command (a B followed by a colon 
and the RETURN key): 


A )B:P 

B) 


The prompt changed to B). You have woken up drive B, and put drive A back 
to sleep. If your drives have LED indicators (red lights), drive A probably went off 
and drive B went on. 

Now that you are in the world of drive B, you must tell CP/M that a new disk 
has been inserted. Don’t ask why — this is customary procedure for introducing a 
disk to CP/M. Hold down your CONTROL key (sometimes marked CTRL, CNTL 
or ALT) and type a C. Your screen should display |C (the f stands for the CON¬ 
TROL key). This is explained further in “Inserting Disks.” 

For more examples, go back to drive A with the following command: 

B )A:P 

A) 


Filenames and the DIR Command 

You may already know the DIR command (type DIR and press RETURN). 

The DIR command displays a directory listing of filenames . CP/M finds a file 
by using its name. The three letters following each filename indicate the type of each 
file. For example, “COM” (and also “CMD” for CP/M-86) tells you that the file 
contains a program that can be used as a command. These three letters are called the 
file type or filename extension. 

The three-letter extension is actually part of the file’s name, and is used to dif¬ 
ferentiate types of files. For example, you may have files with the “COM” extension 
(programs used as commands), files with the “TXT” extension (files holding the text 
of documents), files with the “DOC” extension (files holding entire documents), etc. 
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The following 

shows two DIR commands 

— one in CP/M-80 and one in 


CP/M-86: 




CP/M-80 


CP/M-86 


A )DIRP 


A )DIRD 


A:ASM 

COM 

A:ASM86 

CMD 

A:DDT 

COM 

A:COPYDISK 

CMD 

A:ED 

COM 

A:DDT86 

CMD 

A:PIP 

COM 

A:ED 

CMD 

A:STAT 

COM 

A:PIP 

CMD 

A:SYSGEN 

COM 

A:STAT 

CMD 


Your DIR display may look different, since your disk has different files. Most 
of the filenames shown above should be on your system disk (the disk in drive A). For 
example, you should have a file named PIRCOM, which is used in subsequent exam¬ 
ples. CP/M-86 users can also have special files called system files that are not dis¬ 
played with ordinary DIR commands. You must use the DIRS command (substitute 
the keyword “DIRS” for “DIR” in the examples) to display filenames of system 
files. 

The DIR command by itself displays the entire directory list of files on disk. 
You can also use the DIR command to find a file in the directory listing by specifying 
the filename with DIR. You must specify the entire filename, including the exten¬ 
sion, by typing the name, followed by a period, followed by the extension. 

For example, to see if the file PIP with the extension COM (PIP.COM) is on 
the disk, type the following DIR command: 


CP/M-80 

A)DIR PIP.COM P 


CP/M-86 

A )DIR PI PCM DP 


fcr NOTE: You get the message NO FILE if you do not have a file named PIP.COM 
(PIP.CMD in CP/M-86) on the disk in drive A. Try looking for a file named 
STAT.COM (STAT.CMD). Both are utility programs usually supplied with 
CP/M (“CMD” files are supplied with CP/M-86). 

Creating a File: 

In order to understand files, you may want to create one for use in examples 
and to use in experiments with CP/M commands. CP/M provides only one way to 
create a file: using ED, the text editing program, to create a text file. 

Since there are much better word processing programs than ED to use to cre¬ 
ate files, we urge you to try using WordStar, Select, Magic Wand, or whatever word 
processing program you have, to create a file. If you have no word processing pro¬ 
gram, consult the ED tutorial in your manual supplied with CP/M (or see DataCast 
# 2 ). 

If you have neither the time nor inclination to use another word processing pro¬ 
gram or to learn ED, try this simple exercise to create an empty file, which can then 
be used in subsequent examples. Type the following ED command: 

A ) EDSAMPLE.TXT P 

NEW FILE 

. * 


You can now type the letter E (followed by RETURN) to leave the ED pro¬ 
gram and save SAMPLE.TXT: 

:*EP 

A) 
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Once you have a file named SAMPLE.TXT, you can use the examples in this 
tutorial (you can substitute any file’s name for the name SAMPLE.TXT in the ex¬ 
amples in this article). Using CP/M you will make a copy of the file, rename its copy, 
display the file’s contents on your screen, and print the file. 

Filename Rules: 

Here’s a summary of the rules governing filenames (the italic parts are option¬ 
al): 


d.filename.ext 

The filename is a unique name for the file (up to eight characters). The op¬ 
tional .ext is a typical three- character extension used to indicate the type of file. You 
can use fewer than eight characters for the name and fewer than three characters for 
the extension. You can name a file with no extension, or with an extension and no 
name; the unnamed portion is set to blanks. 

You can also specify with the filename the optional d: — a disk drive letter 
followed by colon — to specify a file on a disk other than the current disk indicated in 
the prompt. Drive A is indicated by the prompt A), drive B is indicated by the 
prompt B), and so on. If you have a file named SAMPLE.TXT on the disk in drive B, 
you could type the following command (while the A) prompt is displayed) to see a 
directory listing of it: 

A) DIR B.SAMPLE. TXTP 

Of course, you get a disk error message (DRIVE B NOT READY) if you have 
no disk in drive B. You get the message NO FILE if you do not have a file named 
SAMPLE.TXT on the disk in drive B. 


File Naming 

The basic idea is to use names that describe the file well enough to tell you what 
is in the. file. You don’t want to have to look inside a file to know what it contains. As 
with file folders and descriptive labels, you use a name that identifies the file and 
makes it unique. 

You can use letters, numbers, dashes, slashes, plus signs, dollar signs, pound 
signs, etc. For example, we use the following filenames for files that hold the text of 
of a book: 

CHAP1-1.TXT — Part one of chapter one. 

CHAP1-2.TXT — Part two of chapter one. 

CHAP2-1.TXT — Part one of chapter two. 

-OUTLINE.TXT — Outline, not full document 
08/02/82.TXT — Entry for an on-going diary. 

Many of the popular filename extensions, or file types, were invented by pro¬ 
grammers from the forgotten years of timesharing and batch programming. Here’s a 
list of extensions we’ve found on a variety of CP/M systems (a list like this cannot be 
complete): 

.ASM Source file of an assembly language program. 

.BAK Backup copy of a text or data file. 

.BAS Source file of a BASIC program. 

.COB Source file of a COBOL program. 

.COM File containing an executable program or transient command. 

.CMD File containing an executable program or transient command for CP/M-86 
system. 

.DAT File of character or numeric data. 

.DOC File of messages or documentation. 

.FOR Source file of a FORTRAN program. 

.HEX A file of hexadecimal values in the Intel format (created by the ASM pro¬ 
gram). 
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.INT File containing a CBASIC executable program (created from a “.BAS” 
file). 

.LIB File (library) containing source routines for programs. 

.LST File containing a printable listing of a program. 

.MAC Source file of an assembly language subroutine. 

.MSG File containing one or more messages. 

.PAS Source file of a Pascal program. 

.PCO File containing a Pascal executable module. 

•PRL Page-relocatable MP/M file. 

.PRN Printable file prepared by text formatter or other program. 

.REL Relocatable MBASIC program file. 

•SAV System file in CP/M version 2.0 and newer. 

.SRC Source file from the CP/M User’s Group. 

.SUB Source file of commands for the SUBMIT program. 

.SYM Symbol table generated by MAC program. 

.TEX Text file to be formatted by the TEX program. 

.TXT General purpose text file. 

.WRK Temporary “work” file created by some programs. 

.$$$ Temporary file created by some programs. 

Don’t worry — unless you intend to do a lot of programming, you will probably 
never use most of these extensions. You will want to use “.TXT” and “BAK” for 
word processing files. You may also use “.SUB” to create files of commands for the 
SUBMIT program. Otherwise, you should know about these extensions in order to 
identify strange files. 

If you have another disk with CP/M files on it (to use in drive B), you can skip 
the “Formatting Disks” and “System Disk Backup” procedures and examples. If, 
however, you have only one system disk, you should follow these procedures and ex¬ 
amples to make a backup copy of it. You don’t want to destroy your only copies of 
files through a typing mistake or careless error. You should always keep two or more 
backup copies of files — one for safekeeping, and one to uphold Murphy’s Law. 


Formatting Disks 

Most customized versions of CP/M require that you prepare a new or recycled 
disk before using it with your system. A program called FORMAT or INIT (for “ini¬ 
tialize”) is usually supplied with your computer. Check your system’s documenta¬ 
tion for a disk formatting, initializing or preparing program (usually called 
FORMAT or INIT). 

A reminder: check to see that your disk is not “write- protected” before you try 
to format it. Floppy disks that are eight-inch in diameter usually require a piece of 
tape covering a notch on the disk jacket (see figure 1) to make them usable (other¬ 
wise they are “write protected”). Floppies that are five- inch in diameter are the op¬ 
posite: they require the notch to be uncovered. 



Figure 1: To remove the “write-protection" that keeps you from changing the 
data on a disk, you use tape to cover the notch of an eight-inch disk, or you remove 
any tape covering the notch of a five-inch disk. 


When you format a disk, the system wipes out any information already on the 
disk and prepares the disk to receive new information (organizes the disk’s sectors 
and tracks). After formatting, the disk is a CP/M disk that cannot be used in a non- 
CP/M system unless it is re-formatted for that system. 
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tw* NOTE for eight-inch disk users: If you prepare the new eight inch disk in 
the standard CP/M single-density single sided format, it should be usable in oth¬ 
er CP/M systems that use eight- inch disk drives. This format is also known as the 
“IBM 3740” format (128 bytes per sector). Most systems offer both the standard 
format and their own unique double-density and double-sided formats that are not 
compatible with other CP/M systems (they are offered for greater data capacity per 
disk). 


The FORMAT and IN IT programs are different for each type of computer; 
however, there are many similarities. Most FORMAT and IN IT programs let you 
specify either drive A or drive B to hold the disk to be formatted. Most FORMAT 
and IN IT programs also perform a verification to check for bad sectors on the disk (a 
bad sector is one that cannot hold information). At the end of the formatting session, 
the programs usually ask you to insert a regular system disk to start (or “boot”) the 
system. 

Most computer manufacturers provide their own proprietary formats that can¬ 
not be used with other computers (usually a double-density or quad-density format). 
The single-density format for eight-inch disks is considered a standard CP/M for¬ 
mat that can be used with any CP/M system using an eight-inch disk drive. (Unfor¬ 
tunately there is no standard five-inch disk format). 

For information on your particular FORMAT or IN IT program, consult your 
manual, or ask your dealer. 

Copying the System Disk 

If you haven’t already done so, you must make a backup copy of your master 
system disk. It is good practice to make a new backup disk after 80 hours of use (us¬ 
ing your old backup disk as the “source” and the new disk as the “destination” of the 
copy). If possible, format a new disk for the new backup, or recycle a good disk that 
contains data no longer needed. Attach a label to the disk before formatting it. The 
label should identify the disk as a system disk, perhaps with the date and an id num¬ 
ber to show that it is a backup of another disk. 

CP/M-86: COPYDISK Utility 

CP/M-86 users (the “sixteen-bit” version) have a new utility called COPY- 
DISK (the COPYDISK.CMD program), which copies all tracks from one disk to 
another disk. Since COPYDISK copies the first two tracks of the disk as well as the 
rest of them, it copies the system itself to the new disk, thus creating a new system 
disk that is an exact duplicate of the original system disk. 

If you have a two-drive system, be sure you have a formatted disk in drive B. If 
you have only one drive, keep the formatted disk ready. Type the following com¬ 
mand: 


A) COPYDISK P 

Enter Source Disk Drive (A-D) ?AP (original system disk) 

Destination Disk Drive (A-D) IBP (new copy) 

Copying disk A: to disk B: 

Is this what you want to do (Y/N) ? YP (answer yes) 

If you have a single drive system, the COPYDISK program will tell you to re¬ 
place your “source” disk (the original) with the “destination” disk (your new copy). 

At the end of the COPYDISK operation, the program asks if you want to make an¬ 
other copy. Answer Yif you do, or N if you want to return to CP/M. 

CP/M-80: Custom Duplicating Programs 

Customized CP/M systems sometimes include customized programs for copy- ' 
ing disks. If you have a single drive system, you must have such a program (the regu¬ 
lar PIP cannot handle single disk drives without modification). 

There are two kinds of custom programs: 
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• Programs that copy everything on one disk to another disk, including the 
system tracks that make the disk a system disk. Follow the specific instruc¬ 
tions for your program. (CP/M-86 users have the COPYDISK program — 
see “CP/M-86: COPYDISK” above). 

• Programs that copy data file and program tracks, but not system tracks. 
Follow the instructions presented here. 

CP/M-80: SYSGEN & PIP 
For Double Drive Systems 

Most CP/M-80 systems have at least two disk drives. If you have a system with 
only one, skip to “Single Drive Systems” first before reading these instructions. 

Insert into drive B the new disk to receive the copy, and format the new disk if 
your CP/M system requires disk formatting. 

The SYSGEN program supplied only with CP/M-80 systems (SYSGEN- 
.COM in the DIR listing for drive A) will place a copy of the system onto your new 
backup disk. Some computers are supplied with a customized SYSGEN program by 
another name, such as SYST1K, CCSGEN, GENSYS, and so on. Check your man¬ 
uals for the name of the program and its instructions. Many of them look and act like 
the regular SYSGEN. 

Execute the SYSGEN program by typing SYSGEN followed by the RE¬ 
TURN key: 

A)SYSGENP 

SYSGEN asks for the “source” drive with the system disk you are using; since 
your system disk is normally in drive A, you can type A followed by the RETURN 
key. Note, however, that if you modified your system and the modified version is run¬ 
ning (i.e., it is in memory) but not yet stored on the disk in drive A, you must skip 
this question by pressing only the RETURN key. 

SYSGEN then asks for the “destination” drive with the disk to receive a copy 
of the system. Type B for drive B (the drive with the disk to hold the copy): 

A)SYSGEN P 

SOURCE DRIVE NAME (OR RETURN TO SKI P):AP 
SOURCE ON A:, THEN TYPE RETURN P 
FUNCTION COMPLETE 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT): BP 
DESTINATION ON B:, THEN TYPE RETURN P 

When SYSGEN completes its function, it displays the message: 

FUNCTION COMPLETE 

If you want to make more copies, insert another new disk into drive B and type 
B to the following question. If you are finished copying the system, press RETURN 
to “reboot” the system: 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT): 

A) 

The SYSGEN program places a copy of the CP/M operating system on the 
first two tracks of the new disk. You can use SYSGEN as shown above to make a 
copy of the system as it is, without change, and place it on disk. 


Wait! There is one more important step. SYSGEN copied only the system soft¬ 
ware to the backup disk. Now you have to copy the programs and other files from the 
system disk to your new backup copy. The easiest way to do this (in the absence of a 
customized COPY or DUP program) is to use the following PIP command: 
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A )PIPB:=A:*.*P 


This command copies all the files on the disk in drive A to the disk in drive B. If 
you employ user areas, this command only copies the files in user area 0 (see “User 
Areas”). 

CP/M-80: SYSGEN For 
Single-Drive Systems 

In the absence of a custom program from your dealer or computer manufactur¬ 
er that copies the system tracks with the rest of the disk, use SYSGEN as described 
above, with the following changes to the procedures: 

After typing A for the “source” drive, and the RETURN key twice, the 
FUNCTION COMPLETE message should appear, followed by the question about 
your “destination” drive. Take out your system disk and replace it with the new disk 
to be the backup. Answer by typing A as the “destination” disk, followed by two RE¬ 
TURN keys, and SYSGEN should copy the system onto the new backup disk. 

To copy all files from the system disk to your new backup disk, you need a spe¬ 
cial customized program for your system, since PIP (described above) only works 
with systems with more than one disk drive. 

If this procedure does not work, consult your dealer or computer manufacturer 
— they must know a way to make backup copies of your master system disk! 

Inserting a Disk: Remember f C 

In most CP/M systems, you use a system disk in drive A to hold your system 
and application programs, and a data disk in drive B to hold your data and text files. 
These disks must be formatted to be used with your system; otherwise, your system 
will not recognize the disk, and the computer will probably “hang” as if in a day¬ 
dream, waiting for you to insert a proper disk (or to reset the system). 

In most cases, when you insert a formatted disk in a drive, or replace a disk in a 
drive with a different disk, you should warn CP/M by typing a CONTROL-C (hold 
down your CONTROL key and type a C). This tells CP/M how to put data on the 
new disk. 

There are times, when using programs like PIP or FORMAT, where you can 
insert a different disk and not type a CONTROL-C (see “Copying Files: Using Two 
Drives”). However, if you try to put data on the new disk, you may get an error mes¬ 
sage (such as Bdos Error On B: R/O). You should then type a CONTROL-C. The 
CONTROL-C (displayed as fC) tells CP/M where data should be stored on the 
disk. 

Switching Drives 

CP/M will always look in drive A for a file, unless you: 

• add a B: prefix to the filename to tell CP/M to look in drive B, or 

• switch to drive B. Simply type the drive prefix as a command: 

A )B:P 

B) 

A DIR command typed after the B) prompt displays the entire directory for 
the disk in drive B. To switch to drive C (if you have one), type C: followed by RE¬ 
TURN. To switch to drive A, type A: followed by RETURN. 

CONTROL Key Combinations 

The CONTROL key (sometimes called CTRL, CNTL or ALT) can be used in 
combination with another key to perform command line editing or other functions. 

Line editing commands help you type command lines and correct mistakes. If 
you make a typing mistake, use the RUBOUT (or DELETE) key. If you’re not sure 
what you’ve typed (some terminals re-display the rubbed-out characters when you 
use RUBOUT or DELETE), try this line editing command: hold down the CON¬ 
TROL key and type R. This combination ( \R ) re-displays your command line with¬ 
out the rubbed-out characters. 
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To delete a line (and not send it to CP/M), use \Xor \U. Here’s a summary of 
the command line editing combinations: 

t E Move the cursor down to the beginning of the next line without performing a 

RETURN. Useful for typing long command lines. 

t H Delete one character and erase it from the screen (move cursor left over the 
previous character). CP/M version 2.0 and newer. 

t / Move the cursor right one tab space (eight or less spaces, to the next “tab 
stop”). 

t J Same as RETURN (line feed). 

t M Same as RETURN (carriage return). 

t ft Repeat the comand line without rubbed-out characters. 

RETURN 

Send the line to CP/M as a command to be acted upon^nd move the cursor 
down to the beginning of the next line. 


RUBOUT 

Delete a character and re-display the “rubbed-out” character. 

]Uor 

]X Delete the command line without sending it to CP/M. 

Other CONTROL key combinations perform useful CP/M functions: 

t C Alert CP/M to the fact that you just inserted a new disk or replaced a disk 
in a drive. Also used to stop (“abort”) some programs (WordStar is an ex¬ 
ception). CONTROL-C restarts CP/M or performs warm start for a newly 
inserted disk. In CP/M- 86, one CONTROL-C while a program is running 
aborts the running program. Without a program running, CONTROL-C 
restarts CP/M-86 (without a disk access) and sets all disk drives to read- 
write status (RW — see “STAT Utility”). 

tft Turn on (or off) your “list” device, usually your printer, to “echo” (repeat) 
everything that occurs on your screen and everything you type. Use f ft to 
turn off this function after turning it on with \P. 

]S Stop long displays on your screen (often used with the TYPE command). 
Continue displaying (“scrolling”) by typing any key except f C. 

t Z Use with the ED or PI P programs to terminate a list of characters or insert¬ 
ed text (used to mark the end of a text file). 


Copying Non-System Disks: 

Instructions For The PIP Utility 

Some CP/M systems have a customized copying program that copies your 
disks faster or easier than the conventional way using PIP. If you have only one disk 
drive, you must have such a program. Consult your manual. 

NOTE: CP/M-86 users have the new COPYDISK program that copies all 
the information on one disk to another disk, including the system tracks if they 
are present on the disk being copied (the source disk). Look back to “CP/M-86: 
COPYDISK Utility” or try the command HELP COPYDISK. 
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PIP Using Three Disk Drives 

The following procedures assume that you have three floppy disk drives: drives 
A, B, and C (if your drives are labeled A, E, and F, substitute E for B and F for C in 
the following procedures). If you have only two drives, skip to the next' section. If you 
use a hard disk, skip to the “Hard Disk” instructions. 

1. Leave your CP/M system disk in drive A. 

2. Insert the disk to be copied into drive B (the original, or source disk). 

3. Insert the receiving disk (the one to hold the backup copies) into drive C 
(your third drive). Be sure that this disk is not write-protected (see figure 
1 ). 

4. If your receiving disk is new (never used before with CP/M), it needs to be 
formatted (look back at “Formatting Disks”). 

5. After formatting the new disk in drive C (if it needed to be formatted), type 
the command C: and press your RETURN key. 

6. When you see the C) prompt, hold down the CONTROL key and type a C. 
The C) prompt should reappear. 

7. Type the command A: (followed by RETURN), wait for the A) to appear, 
and then type this command (followed by the RETURN key): 

A )PIPC:=B:*.*P 


8. Watch the names of the files go by. They are all being copied to the disk in 
drive C. Be patient. 

9. When it finishes, take your new disk out of drive C (you’re done). Put a label 
on the new disk to show that it is a backup of the disk in drive B. You should 
never write directly onto the floppy disk, because too much pressure from a 
ball point pen or pencil will destroy the data. Write on the label before at¬ 
taching the label to the disk. 

Using Two Disk Drives 

The following procedures assume that you have two floppy disk drives: drive A 

and drive B. If you use a hard disk, skip to the “Hard Disk” instructions. 

1. Leave your system disk in drive A. 

2. Insert the receiving disk (the one to hold backup copies) into drive B, as 
shown in figure 2. Be sure that the receiving disk is not write-protected (see 
figure 1). 


Figure 2. Insert the receiving disk into drive B. 
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3. If your receiving disk is new (never used before with CP/M), it probably 
needs to be formatted (look back at “Formatting Disks”). 

4. What about the original (source) disk to be copied? Put it aside for a mo¬ 
ment (figure 2). 

5. Type the command B: and press your RETURN key. 

6. When you see the B) prompt, hold down the CONTROL key and type a C. 
The B) prompt should reappear. 

7. Type the command A: (followed by RETURN), wait for the A) to appear, 
and then type the command PIP (followed by RETURN). An asterisk (*) 
should appear. 

8. Take your system disk out of drive A and replace it with the original 
(source) disk to be copied (see figure 3). 


Figure 3. Take out the system disk and replace it with the original disk 
to be copied. 





9. Type the following command (followed by RETURN): 


10. Watch the names of the files go by. They are all being copied from drive A to 
drive B. Be patient. 

11. When it finishes, take your receiving disk out of drive B (figure 4). Put a 
label on it to show that it is a backup of the disk in drive A. You should never 
write directly onto the floppy disk, because too much pressure from a ball 
point pen or pencil will destroy the data. Write on the label before attaching 
the label to the disk. 


Figure 4. Take the original disk out of drive A, and the new copy disk 
out of drive B, and put the system disk back into drive A. 
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12. Take the original disk out of drive A, and replace it with the system disk 
(figure 4). Do not type anything until you’ve inserted a system disk! 

13. After inserting the system disk, press the RETURN key. The PIP program 
stops, and the familiar A) prompt should reappear. 


Using a Hard Disk 

Systems with a hard disk can make the hard disk act as any drive or set of 
drives. For these instructions, we assume the hard disk is acting as drive A, and that a 
floppy disk drive is acting as drive B. This makes sense, because the hard disk should 
be the most active one, and all system files should be located on it, as well as all appli¬ 
cation programs. The floppy disks used in drive B (or whatever drive is assigned to 
floppy disks) are archival disks used to store copies of programs and data files. 

To copy files from the hard disk, format a new or recycled disk in drive B and 
use PIP: 


A )PIPB:=*.*P 

This command will copy only the files in your current user area to the same 
user area number on drive B. If you don’t use user area numbers to segregate files on 
disk, files are all considered to be in user area zero (the default). 

You can use the USER command to switch to another user area. For example, 
USER 2 followed by RETURN will put you in user area 2 if the system allows you to 
be there (in multi-user systems, another terminal may be using user area 2). 

To copy files from one user area to another, add the [Gn] parameter, where n is 
the user area you are copying from. Initiate the following command from the user 
area to receive the copies: 

OB) USER IP 
IB )PIPA:=B:*.*[GO]P 

This example copies the files from user area 0 on drive B (using the [GO] pa¬ 
rameter) to user area 1 on drive A, because the PIP operation was started from user 
area 1 (as indicated by the IB) prompt). 


Filename Matches 

You typed *. * rather than complete filenames in the above examples. You did 
so to specify all files on the disk at once. 

To see if several files are on a disk, CP/M provides a way to display with DIR 
several files at once without displaying the entire disk directory. A filename match is 
a partial filename with special symbols to match arbitrary characters of a filename. 
They are also known as ambiguous filenames. 

The special symbols are * to match any number of characters, and ?to match 
one character. For example, the ambiguous filename FRE?. * would match the filen¬ 
ames FRE1 ASM, FRE2.ASM, FRET.TXT, FRET.BAK and FREE.BAS. 

In a DIR command to see only the files on drive B containing chapters 
(CHAP 1 .TXT, CHAP2.TXT, and so on), you would type: 

A)DIR B.CHAP7.TXTP 

You can use ambiguous filenames to match files in other commands, such as 
PIP (to copy several files at once) and ERA (to erase several files at once — watch 
out!). 

The following table shows ambiguous filenames and the names they match: 
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Ambiguous Filename 


Filename Matches 


SAMPLE . * 


SAMPLE.ASM SAMPLE.TXT SAMPLE.$$ SAMPLE.T 
SAMPLE.COM SAMPLE.BAS SAMPLE.12 SAMPLE 


SA *.COM 


SAMPLE.COM SAVE.COM SALE.COM SA.COM 


SA??.COM 


SAVE.COM SALE.COM 


*.COM 


All filenames with “.COM” extensions 


*. * or ????????.??? All filenames on the disk 


* or ???????? 


All filenames without extensions 


*SA.COM 


* All filenames with “.COM” extensions 


*An asterisk used as the first character matches any characters up to the ex¬ 
tension, even if you include characters between the asterisk and the extension. 


Using PIP: the Desktop Copier 

The PIP program gives you many ways to transfer information from one file to 
another, and from one disk to another. You can also use PIP to transfer information 
to a device like a printer or modem. 

Most PIP operations involve copying a file from one disk to another (example 
#2); however, some users need to make a copy of a file on the same disk , so that ex¬ 
periments with the file do not endanger the only copy. Remember, two files on the 
same disk should not have the same name (otherwise CP/M may only be able to find 
one of them). 

To make a copy of a file on the same disk, you must give the new copy a differ¬ 
ent name. The following example (#1) shows PIP being used to make a copy of 
SAMPLE.TXT called SAMPL1.TXT. 

Example 1. 

A) PIP SAMPL1. TXT= SAMPLE . TXTP 

PIP forces you to name these files in an unusual manner. You must name the 
new copy first (SAMPL1.TXT), before typing = and the filename of the original 


file. 


It is more likely that you will want to copy SAMPLE.TXT to the disk in drive 
B (if it is not already there). Example #2 shows the PIP command copying a file from 
one disk to another, using the same name for the copy. 

Example 2. 

A) PIP B:=A:SAMPLE. TXTP 

You can also copy a file to another disk and use a different name for the copy: 

Example 3. 

A) PIP B:NEWCOPY. TXT= A:SAMPLE. TXTP 

The PIP command in Example #3 resembles the one in Example # 1. Both use a 
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new name for the new copy, but Example #3 transfers the copy to another disk. It is 
easy to make a mistake with PIP — for example, if you forgot the B: prefix to NEW 
COPY. TXT, the file would have been created on the disk in drive A, not drive B as 
intended. 


Copy All Files to Another Drive 

You can use PIP to copy an entire disk if you use the \ * expression to match all 
filenames. 

cr NOTE: If you separate files on the disk into user areas, PIP will only copy 
files from the current user area To copy files in another user area, you must use 
the [Gn] parameter described later in “User Areas.” 

Example 4. 

A )PIPB:=A:*.*P 


Copy Several Files to Another Drive 

The PIP command in Example 4 copies all files on the disk in drive A to the 
disk in drive B, keeping the same names for the copies. You can also select a group of 
files with a filename match. The following example copies all files with the “.TXT” 
extension from drive B to drive A: 

Example 5. 

A )P!PA~ B:\TXTP 


Multiple PIP Commands 

You can run several PIP operations without having to repeat the keyword PIP. 
Type PIP by itself, followed by RETURN, and the program takes over and displays 
its * prompt: 

Example 6. 

A )PIPP 
★ 


At the * prompt display, you can type many PIP commands without typing the 
keyword PIP Example 7 shows several PIP commands. To leave the PIP program, 
press the RETURN key alone as a command to PIP. Be sure you have a system disk 
in drive A when you leave PIP. 

Example 7. 

* A;= B-.SAMPLE.TXTP (Copying SAMPLE.TXT from drive B) 

*A:=B:*.OVRP (Copying all files with the “OVR” extension) 

COPYING- 

WSOVLYI.OVR 

WSMSGS.OVR 

MAILMRGE.OVR 

* A:= BtWS.COMP (CopyingWS.COM) 

* p (Stopping PIP operations) 

This multiple PIP technique was used before in this article to copy the contents 
of an entire disk to another disk in a two-drive system where neither disk is a system 
disk (see “Copying Non-System Disks”). With the PIP program activated and in 
memory, you can remove the system disk and use drive A to hold the original disk to 
be copied. You must put the system disk back in drive A before leaving PIP. 
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Copy Files to the Printer 

By now you are familiar with the PIP command structure: 

PIP destination = source P 

A CP/M system pretends to have certain devices, whether or not you actually 
have those devices connected to your system. For example, you may not have a print¬ 
er, but CP/M “logically” assumes that you do have one. If you tell CP/M to send a 
file to the printer, CP/M will send it to the “logical” printing device. If you have no 
printer, or if the printer is not connected properly, CP/M may either send the data 
into oblivion and return for the next command, or “hang” until you use your RESET 
button (or key) to restart CP/M. 

Most application programs control the printing operations for you. It is most 
likely that you will print files using programs like WordStar or SuperCalc, not using 
the PIP command. However, PIP provides a simple way to print a file, and even gives 
you several options to use to control the printing. 

To send a copy of a file to your printer, you pretend that the printer is the desti¬ 
nation file by using a special device name in the PIP command: LST: Example 8 
shows the PIP command transfering the file SAMPLE.TXT to the printer, and then 
transferring B:CHAP1.TXT to the printer. 

Example 8. 

A) PIP LST:= SAMPLE . TXTP 
A )PIP LST:= B-.CHAP1. TXTP 

tr NOTE: If the file you send to the printer is not a printable file (i.e., it is a pro¬ 
gram, or file that does not contain straight text), or if the file has special control 
characters that are not familiar to your printer, you may not be able to print the 
file using PIP. The system will “hang” if such problems occur — simply restart the 
system, and check your manuals or check with your system dealer. 

Options such as [F] (filter form-feeds), [Pn] (set page length) and [Tn] (ex¬ 
pand tabs to n spaces) may be useful in print operations (see “Using PIP Options”). 

Concatenate Files 

You can concatenate files (add the contents of a file to the end of another, and 
so on) using the PIP command, and store the result (the joined files) in another file 
without changing in any way the originally separated files. For example, you would 
want to concatenate with PIP separate parts of a chapter into one file in order to 
print the chapter as a unit. 

Example 9 shows a PIP command combining the contents of DAY1.TXT, 
DAY2.TXT, DAY3.TXT, DAY4.TXT and DAY5.TXT into a new file called 
WEEK1.TXT, and in the proper order of days, without disturbing the individual 
“day” files. 

Example 9. 

A) PIP WEEK 1. TXT= DAY1. TXT,DAY2. TXT,DAY3. TXT,DAY4. TXT,DAY5. TXTP 

If you want to combine the contents of the “day” files only for the printer rath¬ 
er than combining them into a new file, you would use the LST: device name (shown 
in Example 8 in place of the filename WEEK 1 .TXT in Example 9. 

Copy To/From Other Devices 

If you want to know a simple way to type a single line of text into a file, see 
Example 10. Otherwise, you can safely skip this section on devices and the next sec¬ 
tion on PIP options. They are here for readers who want to perform special oper¬ 
ations. You may need this information later, but beginners can safely skip to 
“Displaying Files.” (However, if you need to put text into a file for the displaying 
examples, use Example 10.) 
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PIP makes it possible to transfer the contents of files to devices like modems, 
paper-tape punchers or specialized output devices, and to transfer data from input 
devices like modems, paper-tape readers or special reading devices into CP/M files. 
You should consult your manuals before trying these operations (i.e., you should al¬ 
ready know what to do before using special device names in PIP commands). 

The simplest device-transfer operation, using PIP, is the one shown in Example 
10. In this example PIP transfers a line of text you type at your keyboard {CON: 
device) to the file SAMPLE.TXT. Unfortunately, this method only works well for 
typing a single line. You must type a CONTROL-Z (hold down your CONTROL 
key and type Z) to stop the operation. 

Example 10. 

A) P/P SAMPLE.TXT= CON:P 

I TYPE A CONTROL-Z TO STOP TYPING. \Z 

A) 

The device names used with PIP describe logical devices that may exist in your 
system. CP/M can only remember four logical devices at a time: the console display 
and keyboard (CON:), the reader or modem input (RDR: in CP/M-80, AX1: in 
CP/M- 86), the punch or modem output (PUN: in CP/M-80, AXO: in CP/M- 86), 
and the “listing” device (LST:), usually a printer. 

You must use these devices properly in PIP statements. Remember, PIP state¬ 
ments take the form: 

PIP destination = source P 

The CON: device can be a source (input) or destination (output), but the other 
devices are usually one or the other (RDR: or AXI: is used only as a source input 
device, PUN: or AXO: is used only as a destination output device, and LST: is only 
used as a destination output device). 

For more information about physical devices, see “Using STAT” later in this 
article. 


Using PIP Options 

The PIP program lets you specify options in brackets with the source filename 
or device, or with each source filename in a concatenation operation. Some options 
let you modify the contents of the file while in transit to the destination File or device. 
Useful ones for typical PIPoperations are the [Gn], [N], [P] and [V] options. 

The [Gn] option lets you copy a source file located in another user area of the 
disk. Hard disk systems and multiple-user systems can have separate user areas on 
the disk to isolate files from other users. The USER command will move you to a 
different user area. User areas are numbered from zero to fifteen. 

To copy a file from another user area into your own area, use the [Gn] option 
with the other user area number for n. Example 11 shows a PIP command copying 
SAMPLE.TXT from user area 2 of drive B to drive A. 

Example 11. 

A )PIPA:= B:SAMPLE. TXT[G2]P 


The [N]and [P] options are explained briefly in the “CP/M Summary” in this 
issue. The [V] option verifies that the copy made is a correct one. The [V] option 
compares the copied data with the source data before finishing the copy operation. 
Example 12 shows two PIP operations: the first copies a file and verifies that the copy 
is accurate, and the second sends a file to the printer and changes the lines-per-print- 
ed- page to 50 lines (otherwise, PIP uses 60 lines per page). 
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Example 12. 


A) PIP B:=A:FRAGILE. TXT[V]P 
A)PIP LST:= TEXT 101. TXT[P50]P 


If PIP is Aborted... 

You may, at some time, get the nasty message PIP ABORTED or a similar one. 
You may get no message at all, especially if the power fails in the middle of a PIP 
operation. Do not worry. PIP never alters the source file, nor does it change a pre¬ 
existing destination file until the entire copy operation is finished. 

PIP does this by creating a temporary file, with the “.$$$” extension, to hold 
the copied data until the copy is finished. PIP’s “.$$$” file is not deleted until the 
copy is finished and the destination file is updated (or created). Therefore, when you 
are updating an old file by copying a new version into it, you need to have more than 
twice the size of the new version of available space on your destination disk before 
you can do the operation. 

If PIP is aborted for any reason, the “.$$$” file will most likely be on your des¬ 
tination disk. It may be empty, but it may also contain a partial copy. Either way, you 
should try the PIP operation again, after checking to make sure you have enough 
space on your destination disk for at least one extra copy of the file you are copying. 
If a “.$$$” file still exists after multiple PIP operations, check to make sure the PIP 
operations were successful. 

You can delete any “.$$$” files that may exist after aborted PIP operations if 
you intend to use a different destination disk. 

A complete PIP tutorial is beyond the scope of this article (A complete PIP 
tutorial is planned for a future issue o/The User’s Guide — ed.). The “CP/M Sum¬ 
mary’’ in this issue summarizes the PIP options. 


Displaying Files 

You can display the contents of a text file or source program (any file contain¬ 
ing ASCII characters) with the TYPE command. The following example displays 
SAMPLE.TXT (the text in SAMPLE.TXT comes from Example 10 in the previous 
section on PIP): 

A) TYPE SAMPLE. TXTP 

I TYPE A CONTROL-Z TO STOP TYPING. 

A) 

If you’re displaying a large file, the display may move too fast for reading. To 
temporarily stop the display, hold down your CONTROL key and type S (fS). To 
continue the display, type CONTROL-S (fS) again, or any other key. To stop the 
display altogether, type a CONTROL-C (hold down your CONTROL key and type 
C(tC). 


Renaming Files 

To rename any file, use the REN command as shown (use of the “ = ” sign is 
similar to PIP): 

A) REN NEWNAME. TXT= OLDNAME. TXTP 

You always specify the new name first, followed by the equal sign ( = ), then 
the old name. You get an error message if the new name you specify is the name of an 
existing file, or if the old name does not exist in the current directory. 

You cannot rename a file to have a different drive prefix. If you specify a drive 
prefix with either name, you must use the same drive prefix with the other name. 
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Erasing Files 

To erase one or more files, use the ERA command. You can specify an ambigu¬ 
ous filename to match several files, but be careful — first use the DIR command 
with the ambiguous filename to see which filenames match it. Once you ERA a file, 
you cannot recover it without a special disk file recovery program (not supplied with 
standard CP/M). 

The following examples demonstrate use of the ERA command. The last ex¬ 
ample (ERA *.*P) erases all files on the disk in drive B, but first asks for confirma¬ 
tion (waits for you to type Yfor yes or N for no, and press RETURN). Do not type Y 
if you want to save the files. 

A )ERA SAMPLE.TXTP 

A) ERA *.BAKP 
A )B:P 

B ) ERA *.*P 

ALL FILES (Y/N )?YP 

If you get the error message File is R/O, the file you are trying to erase is set to 
“read-only” and must be reset to “read/write” before you can erase it (see “File At¬ 
tributes”). If you separate disk files into user areas, the ERA command will only 
erase files in your user area. 

User Areas 

The ability to separate files into distinct user areas on a disk is provided as a 
convenience for separating files on a large hard disk. CP/M doesn’t keep the files in 
separate areas — it merely adds a user area number to the file’s name and informa¬ 
tion. When you use the DIR command in user area 1, you only see the files in user 
area 1. 

Single-user systems rarely need the protection of user areas. User area zero is 
the assumed user area for all files, unless you change the current user area with the 
USER command, and create files in the other user area. 

To change the current user area, type USER followed by the number of the 
user area: 

A)USER IP 

Some MP/M and CP/M systems display the prompt OA) for user area 0, and 
1A) for user area 1. 

To erase files in another user area, you must change the current user area to 
that area and then use the ERA command. You can PIP a file from another user area 
to your area using the [Gn] option. The following example copies a file from user 
area 2 to the current user area: 

A )PIPA:=A:SAMPLE.TXT[G2]P 

Programs stored in one user area cannot be run from another, unless the pro¬ 
gram is stored in user area zero and has the SYS attribute. Use the STAT command 
to give the SYS attribute to programs that are needed by other users, and store those 
programs in user area 0 so that users in other areas can run them. 


Using The STAT Utility: 

System Statistics and Devices 

Using a personal computer often involves managing files and disks in a way 
that conserves space. The STAT program (STAT.COM supplied with CP/M-80, or 
STAT.CMD supplied with CP/M- 86) displays statistics on disk size, file size, attri¬ 
butes, and devices. 

The STAT displays differ slightly from CP/M-80 to CP/M- 86. The original 
CP/M-80 versions are shown beside the new CP/M- 86 versions. 
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The simplest form of STAT is: 


CP/M-80 

A)STATP 
A: R/W, Space: 76k 


CP/M-86 

A )STATP 

A: RW, Free Space: 76k 


This information tells you that the disk in drive A is a disk you can read or 
write to (it has the R/W or RW attribute), and that it has 76K bytes of space left on it 
for more data. 

One byte is the equivalent of one letter, number, or punctuation symbol. For 
example, if chapter one of your novel contains 1300 characters, it would occupy ap¬ 
proximately 1300 bytes of storage. 

Disk and File Space 

The “K” (or “k”) is your clue to the measurement of disk and memory space. 
“K” stands for 1024 bytes, not 1000. (Why? Computers work faster with binary 
numbers, and 2 is a multiple of 8 and 16, which in turn are multiples of 1024). There¬ 
fore, 64K bytes is actually 64 times 1024 bytes. In our example above, we have 76 
times 1024 bytes of space left on the disk in drive A. 

You don’t have to calculate file size by counting characters. A version of the 
STAT command will tell you the size of any file: 

CP/M-80 

A) STAT SAMPLE. TXTP 

Rees Bytes Ext Acc 

5 2k 1 R/W 

Bytes remaining on A: 76k 

CP/M-86 

A) STAT SAMPLE . TXTP 

Drive A: User 0 

Rees Bytes FCBs Attributes 
5 2k % Dir RW 

A: RW, Free Space: 76k 

For simple file calculations, use the Bytes figure (2k) and compare it to the 
number of bytes remaining on disk — 76k. We could increase the size of SAM¬ 
PLE.TXT to be 30 times larger than its present size, and it would still fit on the disk 
in drive A. 

The other figures tell you other things: 

• Rees is the number of 128-byte records in the file (a record is a logical col¬ 
lection of bytes). CP/M always stores data in 128-byte records, even if your 
file has less than 128 bytes. 

• Ext tells you the number of extents occupied by the file. Extents are 16k 
bytes long, and correspond to the number of directory entries for the file. 
CP/M-86 labels this column with FCBs, which stands for File Control 
Blocks, which also correspond to the number of directory entries for the file. 

If you type the $S option (SIZE in CP/M-86), STAT will also display a col¬ 
umn labeled Size. This figure is the number of virtual records (filled and unfilled) in 
the file. This figure will be the same as Rees in a sequential file, but may differ in a 
random file. 


A:SAMPLE.TXT 


Name 

A:SAMPLE.TXT 
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File Attributes 

The Acc (or Attributes) column tells you the access attribute of the file. In 
CP/M versions 2.0 and newer, and in CP/M-86, you can assign attributes to files 
that prevent inadvertent deletions or overwrites. 

For example, you can use STAT to assign the $R/0 (read-only) attribute to a 
file, which prevents you from deleting the file or writing new information to the file 
(including copying to the file). The $R/W attribute allows both deleting and writing 
operations. 

Once again, there are differences in nomenclature between CP/M-80 and 
CP/M-86. The attributes in CP/M-80 are $R/0, $R/W , SYS and DIR. The corre¬ 
sponding attributes in CP/M-86 are RO, RW, STS and DIR. 

The $SYS or SYS attribute makes the file a system file, whose name does not 
appear in a DIR command (CP/M-86 provides DIRS to see names of system files). 
The $DIR attribute is the opposite of $SYS, used to make a system file a normal file 
whose name does appear in a DIR command. 

When user areas are used, a program with the $SYS attribute in user area 0 
can be run from other user areas. 

The following example shows two attribute assignments in both CP/M-80 and 
CP/M-86 — SAMPLE.TXT is set to read-only, and WS.COM is set to be a system 
file: 


CP/M-80 

A.) STAT SAMPLE. TXT $R/OP 
SAMPLE.TXT SET TO R/0 
A)STAT WS.COM $SYSP 
SAMPLE.TXT SET TO SYS 


CP/M-86 

A) STAT SAMPLE. TXT ROP 
SAMPLE.TXT set to RO 
A)STAT WS.COM SYSP 
SAMPLE.TXT set to SYS 


SAMPLE.TXT is now a “read only” file that cannot be deleted or written to 
without an error message. We recommend that you use the read-only attribute for 
“.COM” or “.CMD” files (command files or program files). WS.COM is set as a 
system file so that it does not show up in DIR displays. It can also be stored in user 
area 0 of a disk, and be used from different user areas of that disk. 

Disk Attributes 

STAT can display information about disks in other drives. For the disk in drive 
B, type the following command: 


CP/M-80 

A) STAT B:P 

Bytes remaining on B: 196k 


CP/M-86 

A) STAT B:P 

B: RW, Free Space: 196k 


STAT with the DSK: option gives you disk statistics: 


CP/M-80 

A)STATDSK:P 
A:Drive Characteristics 
65536:128 Byte Record Capacity 
8192:Kilobyte Drive Capacity 
128:32 Byte Directory Entries 
0:Checked Directory Entries 
1024:Records/Extent 
128:Records/Block 
58:Sectors/Track 
2:Reserved Tracks 


CP/M-86 

A)STAT DSK:P 
A:Drive Characteristics 
65536:128 Byte Record Capacity 
8192:Kilobyte Drive Capacity 
128:32 Byte Directory Entries 
0:Checked Directory Entries 
1024:128 Byte Records/Directory Entry 
128:128 Byte Records/Block 
58:128 Byte Sectors/Track 
2:Reserved Tracks 
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You can also assign the R/O or RO (read-only) attribute to an entire disk using 
STAT. To make the disk in drive B read-only (so that no one can delete files or copy 
new files to it), type this command: 


CP/M-80 


CP/M-86 


A)STATB:=R/OP 


A) STAT B:=ROP 


After setting an entire disk to read-only with R/O (or RO ), any PIP or write 
operation to the disk causes the error message BDOS ERR ON d:R/0. If you press 
any key in CP/M-80, the disk reverts back to being a normal readable and “write- 
able” disk (in CP/M-86, use CONTROL-C to change the disk back to a “write- 
able” disk). 

The read-only attribute for a disk does not protect the disk in the same way as 
the write-protect feature on the floppy disk itself. In CP/M-80, the disk automati¬ 
cally reverts back to being a read-write disk after you press any key. Obviously, this 
mechanism is simply a reminder that you once used STAT to set this disk as read¬ 
only. In CP/M-86 you can easily change the read-only attribute to read-write by 
simply resetting the system or using a CONTROL-C (f C) command. 

If you want to protect a floppy disk more than temporarily, use the physical 
write-protect features of the disk. Eight-inch floppy disks have a notch that must be 
covered in order to write to the disk (or copy to the disk); therefore, eight-inch disks 
are protected if the notch is uncovered. Most five-inch floppy disks have a write-pro¬ 
tect notch that must be covered in order to protect it from writes. If you are confused, 
ask your floppy disk dealer for the right procedures to protect and un-protect your 
disks. 


Device Assignments 

CP/M can remember four devices at any one time: the CON: (console and 
keyboard) device, the RDR: (AXO:) device (usually a modem), the PUN: (AXI:) 
device (usually a modem), and the LST: (printer) device. 

CP/M lets programmers create more than four physical device drivers that 
can control the actual devices. However, since CP/M can only remember four at a 
time when running, the programmer must choose four physical device drivers by 
name, and assign them with the STAT command to the logical names CON:, RDR: 
(or AXI:), PUN: (or AXO:), and LST:. 

The following STAT command assigns the physical device driver for a special 
printer ( UL1: for user-defined list device #1) to the logical LST: device: 


A )STATLST:=UL1:P 


To see what physical devices are assigned to the logical devices in your current¬ 
ly-running version of CP/M, type the following command: 


A) STAT DEV:P 


To see what physical device names can be used in STAT assignments, substi¬ 
tute the word VAL: for DEV in the above example. 

A STAT tutorial is also beyond the scope of this article. The STAT options and 
device names are summaried in the “CP/M Summary” in this issue. 
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SUBMIT Utility: 


Submitting a Batch of Commands 

One recurring activity for those who use text editing or word processing pro¬ 
grams is to make copies of text files and erase the temporary “.BAK” files that are 
created by the text editing programs. 

If your backup disk is in drive B and your text files are in drive A, you can per¬ 
form this activity by typing two commands: 

A) P/P B:=A:*.TXTP 

(Copy all text files to drive B.) 

A )ERA *.BAKP 

(Erase all “.BAK” files in drive A.) 

If you need to repeat these commands a lot, you can create a file to hold these 
commands, and submit the file for execution in order to execute them. (We use two 
commands in this example, but you will want to use the SUBMIT facility to repeat 
execution of many commands, to avoid re-typing them.) 


1. Create a text file that has a “.SUB” extension rather than a “.TXT” exten¬ 
sion, and type the commands into the file as text. We recommend that you 
use a suitable text editing program such as WordStar; however, the follow¬ 
ing instructions show how to use the free text editor supplied with CP/M: 
the ED (ED.COM) program: 

A)ED CLEANUP.SUBP 

(The ED program displays the following prompt:) 

. * 

(Now type the / command to insert the text:) 

:*IP 

1 .PIP B:=A:\TXTP 
2.ERA A:\BAKP 

3: 

(Now press the CONTROL key and type Z to stop inserting text:) 

3:t ZP 
2 :* 

(Now use the ED program’s B#T command to display the edit buffer:) 

2 :*B#TP 

1:PIPB:=A:\TXT 
2:ERA A:*.BAK 

2 :* 

(Now type the E command to end the ED session:) 

2 :*EP 

(You now have the file CLEANURSUB in drive A.) 


2. With CLEANUP.SUB in drive A, type the following command: 

A)SUBMIT CLEANUPP 

The commands now execute automatically. However, the real power of SUB¬ 
MIT is the ability to use parameters with commands that can be assigned values 
when typing the SUBMIT command. 

For example, to make the CLEANUP.SUB program work for any type of file, 
including all files on the disk, you would substitute the parameter $1 for the filen¬ 
ames in the CLEANUP.SUB file: 

PIP B:=A:$1 

ERA A:$1 
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A )ED CLEANUP.SUBP 

(The ED program displays the following prompt:) 

. * 

(Type the #4 command to bring in the contents of CLEANUP.SUB:) 

:*#AP 

1: (Now type the #S command to substitute new text for old text throughout the file:) 

1:'* #S Z$1 P (Substitute “$ 1 ” for “*”) 

(Now use the ED program’s B#7" command to display the edit buffer:) 

1 :*B#TP 

1:PIP B:=A:$1.TXT 
2:ERA A:$1.BAK 

2 :* 

(Now type the E command to end the ED session:) 

2 :*EP 

(You now have an edited version of the file CLEANUP.SUB in drive A.) 


When submitting this file to the SUBMIT utility, you would also type the 
name of the file, or a filename match, to be substituted for $1 in the CLEANUP¬ 
.SUB file: 

A > SUBMIT CLEANUP SAMPLEP 

SUBMIT creates a temporary file called $$$.SUB to hold the commands with 
the substitution performed, and then executes the commands automatically: 

PIP B:=A:SAMPLE.TXT (“SAMPLE” replaces “$1”) 

ERA ArSAMPLE.BAK 

You could SUBMIT the CLEANUP file with a filename match rather than a 
single filename, and perform the cleanup operation on all the “.TXT” and “.BAK” 
files on the disk: 

A) SUBMIT CLEANUP *2 


Explore CP/M ... 

Or Relax and Use It 

It’s not hard to believe that most of you beginners made it this far. You really 
do not have to learn everything about CP/M to run it or use it to run application 
programs. 

You are now armed with just enough information, and with an adequate supply 
of buzz words and phrases, to deal competently with computer salespeople, service 
technicians, CP/M application programmers, and systems consultants. 

Your experience is also enhanced with shortcuts and techniques for performing 
complex system operations. In no time you’ll be “batching” your commands into 
SUBMIT files, “PIP-ing” files to and from far away places, RENaming and ERAs- 
ing files and programs, checking disk and file STATistics, and searching DIRecto- 
ries for important files. 

You also have a choice: to continue exploring the CP/M system and eventually 
learn how to “patch” programs and fix “bugs” with DDT and use other CP/M utili¬ 
ties, or to settle back comfortably with CP/M at your control, and move on into seri¬ 
ous application programs. The “Impatient User’s Guide to CP/M” in this issue 
should help you locate specific instructions and rules for the CP/M commands 
you’ve learned, and for commands and options you haven’t yet explored. 0 
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An Impatient User’s Guide , 


CP/M Quick Reference 

A guide for CP/M-80 and CP/M-86 


by Tony Bove & Cheryl Rhodes 


t 2 r NOTE: In this guide, the f symbol stands for the CON¬ 
TROL (CTRL, CNTL or ALT) key, and the P symbol 
stands for the Carriage Return (RETURN, CR or EN¬ 
TER) key. We use this typeface to show what you should 
type, with UPPER CASE letters for keywords and lower 
case letters for words or values you must supply when typing 
the commands. The italic lowercase letters show optional 
words or values you can supply. Finally, we use THIS TYPE¬ 
FACE to show messages displayed by programs or by the sys¬ 
tem. 

CP/M stood for “Control Program/Monitor” when it 
was originally designed; its more popular meaning is “Con¬ 
trol Program for Microcomputers.” 

CP/M is an operating system from Digital Research, 
Inc. that can be used with many different computers that are 
based on the Z80 microprocessor (Zilog) or based on the 
8080, 8085, 8086 or 8088 microprocessors (Intel). Many dif¬ 
ferent microcomputers are based on these microprocessors. 

The primary use of CP/M is to control your computer 
in order to run application programs. There are three types of 
CP/M commands: 

• CONTROL key combinations (such as fC, or 
CONTROL-C) used to restart the system, or per¬ 
form command line editing and other functions. 

• Built-in commands (such as DIR) that are part of 
the system software. 

• System programs (also known as “transient com¬ 
mands”) that reside on disk (such as PIP.COM or 
PIP.CMD). 

CP/M is supplied on one floppy disk, which can also 
contain other programs that run in a CP/M system. This 
floppy disk is called the system disk . The system software re¬ 
sides on the first two tracks of the system disk, and other pro¬ 
grams, including some CP/M commands, occupy other 
tracks. 


Filenames and the DIR Command 

The DIR command displays a directory listing of filen¬ 
ames'. 

A)DIRP 

Here’s a summary of the rules governing filenames: 

d:filename.ext 


• The filename is a unique name for the file (up to 
eight characters). 

• The optional .ext is a typical three-character exten¬ 
sion used to indicate the type of file. You can use 
fewer than three characters. 

• A filename can have a name with no extension, or an 
extension with no name; the unnamed portion is set 
to blanks. 

• The optional d: is a disk drive letter followed by a co¬ 
lon — to specify a file on a disk other than the cur¬ 
rent disk indicated in the prompt. 

You can also use the DIR command to find a file in the 
directory listing by specifying the filename with DIR. You 
must specify the entire filename, including the extension: 

A)DIR PIP.COMP 

Drive A is indicated by the prompt A), drive B is indi¬ 
cated by the prompt B), and so on. If you have more than one 
disk drive, your second drive is called drive B, your third drive 
C, etc. 

If you have a disk in drive B, you can see the directory 
listing for the file SAMPLE.TXT on the disk in drive B by 
typing the following command (next to the displayed A) 
prompt): 

A) DIR B:SAMPLE. TXTP 
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CONCURRENT CP/M-86 
LETS YOUR COMPUTER 
DO MORE THAN 
ONE THING 

AT A TIME. 


Another productivity breakthrough 
from the creators of CP/M". 


If you have to wait impatiently for your microcomputer to 
finish a job before moving on to another task, you need 
Concurrent CP/M-86. Digital Research introduces 
new software technology to increase the producti¬ 
vity of 16-bit microcomputers, including IBM’s 
Personal Computer. 

Using Concurrent CP/M-86, you can run several 
programs simultaneously, switching instantly from *■ 

one program to another. For the first time you can 
write text while printing other documents. For the 
first time you can see directories without leaving 
your application program. For the first time you 
can edit programs while your computer compiles. 
Concurrent CP/M-86 is the best investment you 
can make in microcomputing, because it multiplies 
the value of your hardware, it lets you use all the 
CP/M-86 compatible programs, and if you're develop¬ 
ing software, it insures that you’re on the crest of the 
hottest new wave in the business. 

As the chart shows, there's nothing else like Concurrent 
CP/M-86 in the microcomputing world, and only Digital 
Research offers it. For information, call or write Digital 
Research Inc., P.O. Box 579,160 Central Ave. Pacific 
Grove, California 93950 (408) 649-3896. 


^AL 


Rese 4Rch- 


^'tai 




Europe 

Vector International 
Research Park 
B-3030 Leuven 
Belgium 

32 (16)20-24-96 
Telex 26202 VECTOR 


Far East 

Microsoftware Associates 

6 Floor A. Y. Building 

3-2-2 Kitaaoyama, 

Minato-ku 

Tokyo 107, japan 

03-403-2120 

Telex 2426875 MSA 


DIGITAL 

RESEARCH 

The creators of CP/M.'* 


Available on 

IBM Personal Computer 

• 

• 

• 



Single-User with 
Background Consoles 

• 





Real-Time Control 

• 




• 

Password Protection 

• 



• 

• 

Time and Date Stamps 

• 


• 

• 

• 

Record and File Locking 

• 




• 

Local Area 

Network Support 

• 

• 



• 

Shipped with Editor, 
Assembler and Debugger 

• 

• 




1 Megabyte 

Memory Management 

• 

• 


• 

• 

Winchester Disk Support 

• 

• 


• 

• 

CP/M File Compatible 

• 

• 





ADDITIONAL FEATURES: 

32 Megabyte File Capacity 

512 Megabyte Disk Capacity 

Real-time message passing nucleus essential for 
multi-tasking, data communications and indus 
trial control applications. 

Supported by existing CP/M-86 compatible 
languages. 


Upward compatible with MP/M-86 


fademarkof Digital Research Inc. 

Bnt CP/M-86, and the Digital Research logo 
5f Digital Research Inc. 
fis a trade name of International Business 
ITCorp. 

fa trademark of Bell Laboratories. 

5c- 86 is a trademark of Intel Corporation, 
fCopyright 1982 by Digital Research 
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Inserting a Disk 

In most CP/M systems, you use a system disk in drive 
A to hold your system and application programs, and a data 
disk in drive B to hold your data and text files. These disks 
must be formatted to be used with your system; otherwise, 
your system will not recognize the disk, and the computer 
will probably “hang” as if in a daydream, waiting for you to 
insert a proper disk (or to reset the system). 

In most cases, after you insert a formatted disk in a 
drive, or replace a disk in a drive with a different disk, you 
should warn CP/M by typing \C (hold down your CON¬ 
TROL key and type a C). This tells CP/M how to put data on 
the new disk. 

There are times, when using programs like PIP or 
FORMAT, where you can insert a different disk and not type 
a CONTROL-C. However, if you try to put data on the new 
disk, you may get an error message (such as Bdos Error On 
B: R/O). You should then type a CONTROL-C. 

Switching Drives 

CP/M will always look in drive A for a file, unless you: 

• put a B: prefix on the filename to tell CP/M to look 
in drive B, or 

• switch to drive B. Simply type the drive prefix as a 
command: 

A )B:P 

B) 

A DIR command typed after the B) prompt displays 
the entire directory for the disk in drive B. To switch to drive 
C (if you have one), type C: followed by RETURN. To switch 
to drive A, type A: followed by RETURN. 

Formatting Disks 

A program called FORMAT or INIT (for “initialize”) 
is usually supplied with your system. When you format a 
disk, the system wipes out any information already on the 
disk and prepares the disk to receive new information (orga¬ 
nizes the disk’s sectors and tracks). After formatting, the 
disk is a CP/M disk that cannot be used in a non-CP/M sys¬ 
tem unless it is re-formatted for that system. 

If you prepare a new or recycled eight-inch disk in the 
standard CP/M single-density single sided format, it should 
be usable in other CP/M systems that use eight-inch disk 
drives. 

The FORMAT and INIT programs are different for 
each type of computer. Consult your manual, or ask your 
dealer. 

Copying the System Disk 

Customized CP/M-80 systems may have a program to 
use to copy all tracks of a disk. This is usually the easiest way 
to copy the system tracks to another disk. CP/M-86 systems 
provide COPYDISK for this purpose; uncustomized CP/M- 
80 systems provide (at least) SYSGEN.COM and 
PIP.COM. In all cases (except customized programs), you 
must format a new disk to be of the same type (single or dou¬ 
ble density, single or double sided) as the disk you are copy¬ 
ing. 


CP/M-86: COPYDISK Utility 

COPYDISK (the COPYDISK.CMD program) copies 
all tracks from one disk to another disk: 

A ) COPYDISK P 

Enter Source Disk Drive (A-D) ?AP 

Destination Disk Drive (A-D) ?BP 

Copying disk A: to disk B: 

Is this what you want to do (Y/N) ? YP 

If you have a single drive system, the COPYDISK pro¬ 
gram will tell you to replace your “source” disk (the original) 
with the “destination” disk (your new copy). At the end of 
the COPYDISK operation, the program asks if you want to 
make another copy. Answer Y if you do, or N if you want to 
return to CP/M. 


CP/M-80: SYSGEN & PIP 
For Double Drive Systems 

Most CP/M-80 systems have at least two disk drives. If 
you have a system with only one, skip to “Single Drive Sys¬ 
tems” first before reading these instructions. 

Insert into drive B the new disk to receive the copy, and 
format the new disk if your CP/M system requires disk for¬ 
matting. 

The SYSGEN program supplied only with CP/M-80 
systems (SYSGEN.COM in the DIR listing for drive A) will 
place a copy of the system onto your new backup disk: 

A ) SYSGENP 

SYSGEN asks for the “source” drive with the system 
disk you are using; since your system disk is normally in drive 
A, you can type A followed by the RETURN key. Note, how¬ 
ever, that if you modified your system and the modified ver¬ 
sion is running (i.e., it is in memory) but not yet stored on the 
disk in drive A, you must skip this question by pressing only 
the RETURN key. 

SYSGEN then asks for the “destination” drive with 
the disk to receive a copy of the system. Type B for drive B 
(the drive with the disk to hold the copy): 

A )SYSGENP 

SOURCE DRIVE NAME 

(OR RETURN TO SKIP):AP 

SOURCE ON A:, THEN TYPE RETURN P 

FUNCTION COMPLETE 

DESTINATION DRIVE NAME 

(OR RETURN TO REBOOT): BP 

DESTINATION ON B:, THEN TYPE RETURN <3 

When SYSGEN completes its function, it displays the 
message: 

FUNCTION COMPLETE 

If you want to make more copies, insert another new 
disk into drive B and type Bto the following question. If you 
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are finished copying the system, press RETURN to “reboot” 
the system: 

DESTINATION DRIVE NAME 
(OR RETURN TO REBOOT): <3 
A) 

SYSGEN copied only the system software to the 
backup disk. Now you have to copy all of the programs and 
other files from the system disk to your new backup copy, us¬ 
ing PIP: 

A) P/P B:=A:*.*P 

This command copies all the files on the disk in drive A 
to the disk in drive B. If you employ user areas, this command 
only copies the files in user area 0 (see “User Areas”). 

CP/M-80: SYSGEN For 
Single-Drive Systems 

In the absence of a custom program from your dealer or 
computer manufacturer that copies the system tracks with 
the rest of the disk, use SYSGEN as described above, with 
the following changes to the procedures: 

After typing A for the “source” drive, and the RE¬ 
TURN key twice, the FUNCTION COMPLETE message 
should appear, followed by the question about your “destina¬ 
tion” drive. Take out your system disk and replace it with the 
new disk to be the backup. Answer by typing A as the “desti¬ 
nation” disk, followed by two RETURN keys, and SYSGEN 
should copy the system onto the new backup disk. 

To copy all files from the system disk to your new 
backup disk, you need a special customized program for your 
system, since PIP (described above) only works with systems 
with more than one disk drive. 

CONTROL Key Combinations 

The CONTROL key (sometimes called CTRL, CNTL 
or ALT) can be used in combination with another key to per¬ 
form command line editing or other functions. Check the 
CP/M summary for a list of all of the CONTROL key com¬ 
binations and the functions of special keys. Here are some 
that are used often: 


|C Alert CP/M to the fact that you just inserted a new 
disk or replaced a disk in a drive. Also used to stop 
(“abort”) running some programs (not WordStar). 

t P Turn on (or off) your “list” device, usually your 
printer, to “echo” (repeat) everything that occurs on 
your screen and everything you type. Use \P to turn 
off this function after turning it on with \ P. 

\R Repeat the comand line without rubbed-out charac¬ 
ters. 

| S Stop long displays on your screen (often used with 

the TYPE command). Continue displaying (“scroll¬ 
ing”) by typing any key except t C. 


tl/or 

\X Delete the command line without sending it to 
CP/M. 

RETURN 

p Send the line to CP/M as a command to be acted 
upon, and move the cursor down to the beginning of 
the next line. 

RUBOUT 

Delete a character and re-display the “rubbed-out” 
character. 

Filename Matches 

CP/M provides a way to specify several files at once in 
some commands. A filename match is a partial filename with 
special symbols to match arbitrary characters of a filename. 
They are also known as ambiguous filenames . 

The special symbols are * to match any number of 
characters, and ? to match one character. See the CP/M tu¬ 
torial in this issue for a table that shows ambiguous filenames 
and the names they match. 


Copying Non-System Disks 

Some CP/M systems have a customized copying pro¬ 
gram that copies your disks faster or easier than the conven¬ 
tional way using PIP. If you have only one disk drive, you 
must have such a program. Consult your manual. 

NOTE: CP/M-86 users have the new COPYDISK 
program that copies all the information on one disk to an¬ 
other disk, including the system tracks if they are present 
on the disk being copied (the source disk). Type COPYDISK 
and press RETURN, and the program asks for the source 
and destination drives. The source drive contains the disk to 
be copied, and the destination drive contains the disk to re¬ 
ceive the copied information. 

Using Three Disk Drives 

Insert the disk to be copied into drive B (the original, or 
source disk). Insert the receiving disk into drive C (your third 
drive). Consult your manual for the proper formatting in¬ 
structions, and format the disk in drive C. 

After formatting, type the command C: and press your 
RETURN key (ENTER or CR on some keyboards). When 
you see the C) prompt, hold down the CONTROL (CNTL 
or CTRL) key and type a C. The C) prompt should reappear. 
Type the following commands (each followed by RETURN): 

C)A; <3 

A)PIPC:=B:*.*P 


Using Two Disk Drives 

Insert the receiving disk (the one to hold backup 
copies) into drive B. Consult your manual for the proper for¬ 
matting instructions, and format the disk in drive B. Type the 
command B: and press your RETURN key (ENTER or CR 
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TURN key does not stop input to the file, nor does it transmit 
the required line feed code to move the cursor to the next line. 
Stop input by typing a CONTROL-Z (|Z): 

A)P/P TEXTTXT= CON:P 
Displaying Files 

You can display the contents of a text file or source pro¬ 
gram (any file containing ASCII characters) with the TYPE 
command: 

A) TYPE SAMPLE . TXTP 

To temporarily stop the display, type CONTROL-S 
(t S). To continue the display, press any key. 

Renaming Files 

To rename any file, use the REN command as shown 
(use of the = sign is similar to PIP): 

A) REN NEWNAME. TXT= OLDNAME. TXTP 

You cannot rename a file to have a different drive pre¬ 
fix. 

Erasing Files 

To erase one or more files, use the ERA command: 

A )ERA FREE.BASP 

The following examples erase all “.BAK” files on drive 
A, and then all files on drive B: 

A ) ERA *.BAKP 
A )B:P 

B ) ERA *.*P 

ALL FILES (Y/N)?YP 

If you get the error message File is R/O, the file you are 
trying to erase is set to “read-only” and must be reset to 
“read/write” before you can erase it (see “File Attributes”). 

ERA only erases files in your user area. If you use more 
than one user area on a disk, you have to move to those user 
areas to erase files in them. 

User Areas 

Single-user systems rarely need the protection of user 
areas. User area zero is the assumed user area for all files, 
unless you change the current user area with the USER com¬ 
mand, and create files in the other user area. 

To change the current user area, type USER followed 
by the number of the user area: 

A)USER IP 

To erase files in another user area, you must change the 
current user area to that area and then use the ERA com¬ 
mand. You can PIP a file from another user area to your area 
using the [Gn] option. The following example copies a file 
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from user area 2 to the current user area: 

A) PIP A:=A:SAMPLE. TXT[G2]P 

Programs stored in one user area cannot be run from 
another, unless the program is stored in user area zero and 
has the SYS attribute. Use the STAT command to give the 
SYS attribute to programs that are needed by other users, 
and store those programs in user area 0 so that users in other 
areas can run them. 

Disk and File Sizes 

Use the STAT.COM program (STAT.CMD in CP/M- 
86) to display the available disk space in multiples of 1024 
(or “K”) bytes: 

A )STATP 
A: R/W, Space: 76k 

The display means the disk in drive A is a disk you can 
read or write to (it has the R/W attribute). It has 76K bytes 
of space left on it for more data (roughly 77,800 characters). 

Use STAT with a filename or filename match to display 
the sizes of files: 

A) STAT SAMPLE . TXTP 

Rees Bytes Ext Acc 

5 2k 1 R/W A:SAMPLE.TXT 

Bytes remaining on A: 76k 

Use a filename match to see the sizes of several files: 

A)STAT *.TXTP 

The columns in the STAT display are explained in the 
CP/M tutorial in this issue. 

File Attributes 

The Acc column tells you the access attribute of the 
file. In CP/M versions 2.0 and newer, and in CP/M-86, you 
can assign attributes to files that prevent inadvertent dele¬ 
tions or overwrites. These attributes are: 

Read-Only 

The R/O or RO attribute prevents you from deleting 
the file or writing new information to the file (in¬ 
cluding copying to the file). 

Read-Write 

The R/W or RW attribute allows both deleting and 
writing operations. 

System 

The SYS attribute makes the file a system file, 
whose name does not appear in a DIR command 
(CP/M-86 provides DIRS to see names of system 
files). You must use the [R] parameter with PIP to 
copy system files. When user areas are used, a pro¬ 
gram with the SYS attribute in user area 0 can be 
run from other user areas. 
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on some keyboards). 

When you see the B) prompt, hold down the CON¬ 
TROL (CNTL or CTRL) key and type a C The B) prompt 
should reappear. Type the command A: (followed by RE¬ 
TURN), wait for the A) to appear, and then type the com¬ 
mand PIP (followed by RETURN). An asterisk (*) should 
appear. 

Take your system disk out of drive A and replace it with 
the original (source) disk to be copied. Type the following 
command (followed by RETURN): 

*B:=*.*P 

When it finishes, take your receiving disk out of drive 
B. Take the original disk out of drive A, and replace it with 
the system disk. Do not type anything until you’ve inserted a 
system disk! After inserting the system disk, press the RE¬ 
TURN key. The PIP program stops, and the familiar A) 
prompt should reappear. 

Using a Hard Disk 

Systems with a hard disk can make the hard disk act as 
any drive or set of drives. For these instructions, we assume 
the hard disk is acting as drive A, and that a floppy disk drive 
is acting as drive B. This makes sense, because the hard disk 
should be the most active one, and all system files should be 
located on it, as well as all application programs. 

To copy files from the hard disk, format a new or recy¬ 
cled disk in drive B and use PIP: 

A) PIP B:= *.*P 

This command will copy only the files in your current 
user area to the same user area number on drive B. If you 
don’t use user area numbers to segregate files on disk, files 
are all considered to be in user area zero (the default). 

To copy files from one user area to another, add the 
[Gn] parameter, where n is the user area you are copying 
from. Move to the user area to receive the copies (with the 
USER command), and then use PIP: 

OB )USER IP 

IB )P!PA:=B:*. *[GO]P 

This example copies the files from user area 0 on drive 
B (using the [GO] parameter) to user area 1 on drive A, be¬ 
cause the PIP operation was started from user area 1 (as indi¬ 
cated by the IB) prompt). 

tNOTE: CP/M-86 lets you specify the [Gn] param¬ 
eter on the destination side of the = sign, so that you can 
copy to another user area from the current user area. 

PIP: Copying Files and Disks 

Use the PIP.COM program supplied with CP/M to 
copy files to other disks, or to copy entire disks, in a system 
with two or more disk drives. If you are running CP/M-86, 
use the COPYDISK command to copy entire disks at a time. 

You can type a transfer expression following the 
keyword PIP on the command line, or you can execute PIP by 


typing PIP by itself, and when you see PIP’s * prompt, you 
type several PIP transfer expressions to perform several oper¬ 
ations in a row. 

d) PIP didestiny = d:source P 
d )PIPP 

*d:destiny = d:source<3 
*d:destiny = d:source<3 

d) 


Copying Files 

Copy the original file to the copy file on the same disk: 

A) PIP COPY. TXT= ORIGINAL TXTP 

Copy SOURCE.BAS on the disk in drive A to DES- 
TINY.BAS on the disk in drive B, creating a new DESTIN- 
Y.BAS or overwriting the old one: 

A)PIP B:DESTINYBAS=A:SOURCE.BASP 

Copy ORIGINAL.TXT in drive A to drive B, using the 
same filename for the copy in drive B: 

A)PIP B:=A:ORIGINAL.TXTP 


Copying An Entire Disk: 

Copy the entire disk in drive A to drive B (user areas 
not used): 

A) PIP B:=A:\*P 

To copy an entire disk where files are grouped into user 
areas, use the [Gn] parameter, substituting for each n the 
number of each user area in use on the source disk. Here’s the 
PIP command for copying from user area number 2: 

A)PIP B:=A:\ *[G2]P 


Copy Files to the Printer 

Copy text files to your LST: device (usually a printer): 

A)PIP LST:= B.SAMPLE.TXTP 


Concatenate Files 

Add the contents of FILE3 to the end of FILE2, and 
FILE2 to the end of FILE1, and store in RESULT without 
disturbing FILE1, FILE2 or FILE3: 

A)PIP RESULT= FILE 1,FILE2,FILE3P 


Copy Typed Input to File 

Copy text as you type it into a file. Use of the RE- 
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Directory 

The DIR attribute is the opposite of SYS, and is used 
to make a system file a normal file whose name does 
appear in a DIR command. 

To assign an attribute to a file, specify the following at¬ 
tribute after the filename in a STAT command: 

CP/M-80 
$R/0 (read-only) 

$R/W (read-write) 

$SYS (system) 

$DIR (directory) 

CP/M-86 

RO (read-only) 

RW (read-write) 

SYS (system) 

DIR (directory) 


Disk Attributes 

STAT can display information about disks in other 
drives: 

A)STATB:P 

Bytes remaining on B: 196k 

STAT with the DSK: option gives you disk statistics: 

A) STAT DSK:P 

You can also assign the read-only attribute to an entire 
disk using STAT. To make the disk in drive B read-only (so 
that no one can delete files or copy new files to it), type STAT 
B:= R/O followed by RETURN (in CP/M-86, type STAT 
B:=RO). 

After setting an entire disk to read-only, any PIP or 
write operation to the disk causes the error message BDOS 
ERR ON d:R/0. If you press your RETURN key, the disk 
reverts back to being a normal readable and write-able disk. 
(You must use CONTROL-C in CP/M-86 to change the 
disk to be write-able). 

Device Assignments 

CP/M lets programmers create more than four phys¬ 
ical device drivers that can control actual devices. However, 
since CP/M can only remember four at a time when running, 
the programmer must choose four physical device drivers by 
name, and assign them to the logical names CON:, RDR: 
(AXI: in CP/M-86), PUN: (AXO: in CP/M-86), and LST: 
using the STAT command. 

The following STAT command assigns the physical de¬ 
vice driver for a special printer ( UL1: for user-defined list de¬ 
vice #1) to the logical LST: device: 

A )STATLST:=UL1:P 

To see what physical devices are assigned to the logical 


devices in your currently-running version of CP/M, type the 
following command: 

A) STAT DEV:P 

To see what physical device names can be used in STAT 
assignments, substitute the word VAL: for DEV in the above 
example. 

SUBMIT Utility: 

Submitting a Batch of Commands 

To use SUBMIT with a file of commands, follow these 

steps: 

1. Create a text file that has a “.SUB” extension rather 
than a “.TXT” extension, and type each command 
line into the file. The following instructions show 
how to use the free text editor supplied with CP/M, 
the ED (ED.COM) program, to type a command 
file called CLEANUP.SUB that copies all “.TXT” 
files and erases all “.BAK” files: 

A )ED CLEANUP.SUBP 

(The ED program displays the following prompt:) 

. * 

(Now type the / command to insert the text:) 

:*IP 

V.PIP B:=A:\TXTP 
2.ERA A:*.BAKP 
3: 

(Now press the CONTROL key and type Z:) 

3:tZ<=> 

2 :* 

(Now type the E command to end the ED session.) 
2:*EP 

(You now have the file CLEANURSUB in drive A.) 

2. With CLEANUP.SUB in drive A, type the follow¬ 
ing command: 

A) SUBMIT CLEAN UP P 

To make the CLEANUP.SUB program work for any 
type of file, including all files on the disk, you would substi¬ 
tute the parameter $1 for the filenames in the CLEANUP¬ 
.SUB file: 

PIP B:=A:$1 
ERA A:$1 

When submitting this file to the SUBMIT utility, you 
would also type the name of the file, or a filename match, to 
be substituted for $1 in the CLEANUP.SUB file: 

A) SUBMIT CLEANUP SAMPLE. TXTP 

SUBMIT creates a temporary file called $$$.SUB to 
hold the commands with the substitution performed ( SAM 
PLE.TXT for $1), and then executes the commands auto¬ 
matically. 0 
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An Impatient User's Guide... 


CP/M Summary 

CP/M-80 and CP/M-86 Commands and Utilities 


by Tony Bove & Cheryl Rhodes 


t-r NOTE: In this summary, the f symbol stands for the 
CONTROL (CTRL, CNTL or ALT) key, and the P 
symbol stands for the Carriage Return (RETURN, CR 
or ENTER) key. We use this typeface to show what you 
should type, with UPPER CASE letters for keywords and 
lowercase letters for words or values you must supply when 
typing the commands. The italic lowercase letters show op¬ 
tional words or values you can supply. Finally, we use THIS 
TYPEFACE to show messages displayed by programs or by 
the system. 


CONTROL Key Combinations 

t C Restart CP/M or perform warm start for a newly 
inserted disk. Sometimes used to abort programs. In 
CP/M-86, one CONTROL-C while a program is 
running aborts the running program. Without a pro¬ 
gram running, CONTROL-C restarts CP/M 
(without a disk access) and sets all disk drives to 
read-write status (RW). 

|E Move cursor to beginning of next line for long com¬ 
mand lines. 

BACKSPACE 

or \H Delete one character and erase it from the screen 
(CP/M versions 2.0 and newer). 

\l Add 8 spaces (tab to next 8th column: 8, 16, 24 ...). 

LINE FEED 

or | J Same as the RETURN key (CP/M versions 2.0 and 
newer). 

t M Same as the RETURN key. 

|P Turn on list device to print everything typed or dis¬ 

played (LST: device is usually your printer). Type 
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t P again to turn off list device. 

t R Repeat the command line. 

]S Temporarily stop display; continue by typing any 
character. 

\U or 

t X Cancel the current line (do not transmit it to CP/M). 

t Z End input from keyboard during ED or PIP session. 

P The RETURN, ENTER, or CR (Carriage Return) 

key, used to transmit a command line to CP/M and 
to perform a carriage return and line feed to move 
cursor to next line. 

RUBOUTor 

DELETE 

Delete one character and redisplay it. To display 
corrected commmand line without rubbed-out char¬ 
acters, use t R- 


CP/M Commands 

The following “built-in” commands do not require pro¬ 
gram files on disk, since they exist within CP/M itself. You 
must supply a regular CP/M filename for any filename (or 
optional filename) below, or an ambiguous filename (using * 
and/or ? symbols) for any optional filematch. 


d: Change current disk drive to drive d. Type a drive 

letter for d followed by a colon (;). 


dir te;~i 

\djilematch \ 

Display one or more files. 


DIRS 


ename \ 

\d:filematch\ 

Display one or more system files (files with the SYS 
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attribute). CP/M-86 only. 

fra ■ d: filename ) 

\d:filematch\ 

Erase one or more files. 

REN newname= oldname 

Rename oldname to newname. 

SAVE d.filename 

Save n pages to d. filename. CP/M-80 only. 

I d. filename I 
E | d:filematch\ 

Display contents of one or more text files. 

USERn 

Set current user area to user number n. 

System Programs 
(Transient Commands) 

These programs must reside in files by the same name 
with a “.COM” (CP/M-80) or “.CMD” (CP/M-86) exten¬ 
sion on the current disk drive (usually the disk in drive A). 
For example: PIP.COM for the PIP program in CP/M-80, or 
PIP.CMD in CP/M-86, should be on the disk in drive A or 
the current drive. 

ASM Assembler (CP/M-80) 

ASM filename.ahp 

Assemble the program in filename. ASM in the 
current drive or drive specified by a , put the assem¬ 
bled program (filename. HEX) in the current drive 
or drive specified by h , and put the listing ( filena - 
me.PRN) in the current drive or drive specified by p. 
If you type Z for h or /?, ASM will not generate filen- 
ame. HEX or filename.PRN respectively. If you 
type X for p, the listing will appear at the console 
only (no filename. PRN). 

■ 

ASM-86 Assembler (CP/M-86) 

ASM86 filename $Ad Hd Pd Sd Fd 

Assemble the program in filename. A86 (“.A86” is 
assumed unless you supply an extension as part of 
your filename ), put the assembled version in filen- 
a/ne.H86, create an annotated listing of the pro¬ 
gram called filename. LST, and produce a symbol 
table called filename.SYM. These files are stored 
on the current disk unless you type one or more of 
the following $ options after filename in the 
ASM86 command line. To type one or more options, 
you start by typing the symbol $ The options are: 
Ad Look for the source file on drive d, not the current 
drive. 

Hd Put the assembled “.H86” file on drive d, not the 
current drive. 

Pd Put the listing “.LST” file on drive d, not the cur¬ 
rent drive. 

Sd Put the symbol table “.SYM” file on drive d, not the 
current drive. 


Fd Select format d of hexadecimal file: D for Digital 
Research, or /for Intel. 

X An X for the d value in any option above (except Ad) 

causes the output to go to the screen, not to a file. 

Y A Y for the d value in any option above (except Ad) 
causes the output to go to the printer, not to a file. 

Z A Z for the d value in any option above (except Ad) 
causes the output to go to the “byte bucket” (also 
known as “zero output”), not to a file. 

COPYDISK Utility (CP/M-86) 

COPYDISK 

Copy all tracks from one disk to another disk. 

DDT Debugger (CP/M-80) 

dfilename.HEX | 
d: filename.COM \ 

Load filename.HEX or filename.COM into the 
program area to debug with DDT commands. If you 
do not specify filename.HEX or filename.COM , 
DDT commands act on whatever is already in the 
program area. 

DDT Commands 

As Enter assembly language at address s. 

Ds,f Display memory at current address or address 5 and 
continue for 16 lines or to address/. 

Fs,f,c Fill memory with hexadecimal byte C from address 
s to address f. 

Gs,b,c Start execution at address s, with optional break¬ 
points at addresses b and c. 

G,b,c Start execution at the current address, with optional 
breakpoints at addresses b and c. 

GO Properly terminate DDT session, readying program 
for a SAVE. 

Ifilename 

Insert filename into the file control block (005CH) 
for an R command. 

Ls,f List “disassembled” code from current address or 
address s , and continue for 12 lines or to address/. 

Ms,f,d Move block starting at s and ending at f to destina¬ 
tion d. 

Rb Read file inserted by an / command into program 
area, with optional bias b. 

Ss Examine or alter memory starting at address s. For 
each value, type another value to replace it, or RE¬ 
TURN to keep it, or a period to stop the S com¬ 
mand. 

Tn Trace execution and display all registers and flags 
for one or n execution steps. 

U Untrace (same as the T command, without display 
of registers). 

Xr Examine all CPU registers or examine or alter regis¬ 
ter r, where r is one of the following CPU registers: 
C (carry flag), Z (zero flag), M (minus flag), E 
(even parity flag), / (interdigit carry), A (accumula¬ 
tor), B (BC register pair), D (DE register pair), H 
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(HL register pair), S (stack pointer), or P (program 
counter). 

DDT-86 Debugger (CP/M-86) 

DDT86 d filename.CMD 

Load filename.CMD into the program area to de¬ 
bug with DDT commands (“.CMD” assumed if you 
specify no extension). If you do not specify a file¬ 
name , you cannot use the G, 7, or U commands until 
you load a program to debug (usually with the E 
command). DDT-86 cannot load a program in hexa¬ 
decimal format (“.H86” files) — convert them first 
with the GENCMD utility. 

DDT-86 Commands 

As Enter assembly language statements at starting ad¬ 
dress s. 

BSjf,s1 Compare blocks of memory (starting address s, fin¬ 
ishing address f, second starting address si). 

Ds,f Display memory (in hexadecimal and ASCII) at 
current address or address s and continue for 16 
lines or to address/. 

E filename 

Load filename for execution. 

Fs,f,bc 

Fill memory with hexadecimal byte be from address 
s to address f. 

Fs,f,wc 

Fill memory with hexadecimal word ivc from ad¬ 
dress S to address f. 

Gs,b,c Start execution at address s, with optional break¬ 
points at addresses b and c. 

G,b,c Start execution at the current address, with optional 
breakpoints at addresses b and c. 

Hwc1,wc2 

Hexadecimal sum and difference. 

Icommand tail 

Set up input command line with command tail. 
Ls,f List “disassembled” code from current address or 
address s , and continue for 12 lines or to address/. 
Ms,f,d Move block starting at s and ending at f to destina¬ 
tion d. 

Rfilename 

Read disk file into program area. 

Ss Set memory values (bytes) starting at address s. 

SWs Set memory values (words) starting at address s. 

Tn Trace program execution for one or n execution 
steps. 

TSn Trace program execution and display all registers 
and flags for one or n execution steps. 

Un Untrace (same as the T command, except that the 
CPU state is displayed only before the first instruc¬ 
tion is executed, rather than before every execution 
step). 

USn Untrace (same as the TS command, except that the 
CPU state is displayed only before the first instruc¬ 
tion is executed, rather than before every execution 
step). 
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V Display information about the last file loaded with 
the E or R commands. 

Wfilename,s,f 

Write contiguous block to disk file filename Op¬ 
tional s is the 20-bit starting address of block,/is the 
finishing address (block must start on a paragraph 
boundary, since low four bits of s are ignored). With¬ 
out the optional ,5,/, it assumes the starting and fin¬ 
ishing addresses of the last file read with the R 
command (useful for writing out files after install¬ 
ing patches without changing file length). 

Xr Examine all CPU registers and flags or examine or 
alter r, where r is a register name or one of the fol¬ 
lowing flags: C (carry flag), O (overflow flag), Z 
(zero flag), / (interrupt enable), A (auxiliary carry), 
T (trap), D (direction), S (sign) or P (parity). 

DUMP in Hex 
DUMP d: filename 

Display the file’s contents in hexadecimal. 

ED Text Editing Program 

ED d: filename d: 

ED d: file name d.filename 

Create and/or edit a text file (filename), and op¬ 
tionally specify another disk for the output file, or 
another file. 

ED Commands 

In all ED commands, you can substitute # for any n be¬ 
low to give n the highest value (65535). If you do not specify 
either + or -, ED assumes you mean -T unless otherwise not¬ 
ed. “CP” in all explanations stands for the character pointer 
in the edit buffer. A “string” is a set of ASCII characters. 

± n Perform a ± nLT command (see L and T com¬ 
mands). 

n: Move CP to beginning of line number n. 

nl::n2 

Substitute for any n or optional n below a range of 
lines beginning with nl and ending with n2. If either 
nl or n2 is missing, ED assumes the current line for 
it. 

nA Append n lines or one line from filename into the 
edit buffer. A # for n will append 65535 lines (fill 
the buffer), and a zero for n will fill half of the buff¬ 
er. 

±B Move CP to beginning ( + ) or end (-) of the edit 
buffer. 

£?#7 Move CP to beginning of buffer and display entire 
buffer. 

±nC Move CP forward ( + ) or backward (-) n charac¬ 
ters. 

± nD Delete one or n characters in front of (+) or behind 
(-) the CP. 

E End ED session and close files (normal end of ses- 
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sion). A backup (“.BAK”) file preserves the unedit¬ 
ed version. 

nFstring\Z 

Find string once or n times; use optional CON- 
TROL-Z (f Z) at end of string to type another ED 
command on same line. 

H Save and re-edit file (perform an E command, then 
run ED.COM again to edit the file). 

1st ring 

Insert lines of text, or just string , moving CP to end 
of inserted lines or characters. If inserting lines, end 
the insert session with CONTROL-Z (\Z). I inserts 
upper case characters only (see U command). 

is t ring 

CP/M versions 2.2 and newer: insert upper and low¬ 
er case characters, as typed. (Otherwise, same as the 
/ command). 

nJ string 1 f Zstring2\ Zstring3\Z 

Find string 1, append string2 to string t and delete 
all characters up to but not including string3 (jux¬ 
tapose all three strings). Use optional \Z at end of 
String3 to type another ED command on same line. 

±nK Delete the following (+) or previous (-) n lines. 

±nL Move CP to beginning of current line if n is zero, or 
move CP down ( + ) or up (-) n lines. 

nMstring\Z 

Repeat execution of the string of ED commands n 
times. If n is zero or one, repeat indefinitely (until an 
error occurs). Use \Z to type another ED command 
on same line. 

nNstring\Z 

Search for the mh occurence of string throughout 
the file. Use \Z to type another ED command on 
same line. 

O Omit the ED session, and keep the original unedited 
file. 

± nP Display n pages (24 lines per page) of the buffer pre¬ 
vious to (-) or following (+) the CP. A zero for n dis¬ 
plays the current line and the following 23 lines. 

Q Quit the ED session with no file alterations. Tempo¬ 
rary and source files remain as they are, but a pre¬ 
vious “.BAK” file of the source file is deleted (be 
careful — check first to see if you need the previous 
“.BAK” file). 

Rfilename 

Read filename.LIB or the file X$$$$$$$.LIB and 
insert the text into the buffer, moving CP to end of 
inserted text. 

nSoldstring] Znewstring\Z 

Find oldstring in the buffer and substitute newstr- 
ing for it; repeat the operation n times if n is greater 
than one. 

±nT Display the following ( + ) or previous (-) n lines, or 
the current line if n is zero. If n is not specifed, T dis¬ 
plays the current line after (+) or before (-) the CP. 
The command sequence S#7 displays the entire 
buffer. 

± U Translate all characters typed to UPPER case ( + ), 
or turn off translation (-). 

± V Turn on ( + ) or off (-) line number display for lines 
in the buffer. 
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0V Display number of free bytes left in the buffer, and 

the total buffer size, in decimal values. 
nW Write to the temporary output file (“.$$$” file type) 
the following n lines or only the current line. 
nX Copies the following n lines to the file 
X$$$$$$$.LIB (retrieve them with the R com¬ 
mand). If n is zero, this command will delete the file 
X$$$$$$$.LIB. 
nXfilename 

CP/M-86 only. Copies the following n lines to file¬ 
name or appends if previous X command applied to 
the same file. If n is zero, this command will delete 

filename. 

nZ Suspend the ED session for approximately n sec¬ 
onds. 

GENCMD: Convert “.H86” Files 
to “.CMD” Files (CP/M-86 only) 

GENCMD d: filename option-list 

The option-list can contain one or more of the fol¬ 
lowing paramters which define segment groups with 
specific memory requirements: 

8080 (8080 memory model) 

CODE [An,Bn,Mn,Xn] 

DATA [An,Bn,Mn,Xn] 

STACK [An,Bn,Mn,Xn] 

EXTRA [An,Bn,Mn,Xn] 

Convert hexadecimal “.H86” file into an executable 
“.CMD” file. In optional parameters controlling the 
type of memory model, specify addresses ( n ) that 
are paragraph boundaries. An loads the group at ab¬ 
solute location n. Bn specifies beginning of group at 
address n in hexadecimal file. Mn specifies require¬ 
ment of minimum of (n x 16) bytes. Xn specifies that 
the group can address up to (n x 16) bytes. 

LOAD: Convert “.HEX” Files 
to “.COM” Files (CP/M-80 only) 

LOAD d: file name 

Convert filename. HEX to an executable program 
called filename COM. 

MOVCPM: Reconfigure For Memory Size 
(CP/M-80 only) 

M 

MOVCPM n | * 

Prepare a new copy of system to utilize nK bytes of 
memory or all available memory (substitute * for n). 
An asterisk (*) after n (or after the first asterisk) 
prepares the copy for a SYSGEN. In versions 1.3 
and 1.4, n can be from 16 to 64; in versions 2.0 and 
newer, 20 to 64. 

PIP: Copy Files To Disks and Devices 

PIP destination^ sourceP 

Run the PIP program with one transfer expression. 
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PIP p 

* destination=source P 
*destination= source P 

* P 

Run PIP to perform several operations. End PIP ses¬ 
sion by pressing RETURN. Transfer expressions 
can take any of the following specific forms (d: is a 
required disk drive prefix with colon, d: is an option¬ 
al drive prefix with colon, and [p] represents option¬ 
al parameters shown at the end of this section). 

dnewcopy= d:original[p] 
d:newcopy= doriginalfpj,doriginal[p ]... 

Copy one file to another using new name for the 
copy, or concatenate the contents of several files into 
a new file with the name newcopy. 

d:=d:original[p ],... 
d:=d:filematch[p ],... 

Copy one or more files to another disk, using the 
same filenames. You can use a filematch such as 
SAMPLE77.TXT or *.*, The first d: is required, 
since another disk must be specified. 

dev:=d:filename[p ],... 

Send the contents of one or more source files to an 
output device. 

d:fi!ename=dev:[p ],... 

Transfer the input from an input device to a destina¬ 
tion file. 

PIP Device Names: CP/M-80 

CON: Console display and keyboard (input and output) 
RDR: Reader device (input only) 

PUN: Punch device (output only) 

LST: List device, usually a printer (output only) 

Special PIP “devices” are not devices: they perform 
special functions associated with devices. They are: 

NUL: Send 40 “nulls” (ASCII value of 0) to file or device. 
EOF: Send an “end of file” mark (ASCII 1 AH, or \Z) to 

file or device. 

OUT: A custom device for data output. PIP must be modi¬ 
fied for it. 

INP: A custom device for data input. PIP must be modi¬ 

fied for it. 

PRN: A special form of LST: which handles tabs and page 
breaks and numbers lines. 

PIP Device Names: CP/M-86 

CON: Console display and keyboard (input and output) 
AXI: Auxiliary input device (input only) 

AXO: Auxiliary output device (output only) 

LST: List device, usually a printer (output only) 

Special PIP “devices” are not devices: they perform 
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special functions associated with devices. They are: 

NUL: Send 40 “nulls” (ASCII value of 0) to file or device. 
EOF: Send an “end of file” mark (ASCII 1 AH, or \Z) to 

file or device. 

PRN: A special form of LST: which handles tabs and page 

breaks and numbers lines. 

PIP Parameters 

In all forms of PIP expressions, optional (fpj) param¬ 
eters can be specified to perform special functions. Letters 
for p are: 

B Block mode transfer, used to read data from paper 
tape (CP/M-80 only). 

Dn Delete any characters after the nth column; used to 
send wide lines to a device that only handles narrow 
lines. 

E Display (“echo”) copy operation as it is performed. 
F Filter out form feeds (ASCII value OCH, or “FF” or 

\L). 

Gn Get file(s) from user area n (CP/M version 2.0 or 
newer). 

H Check for proper Intel hexadecimal format records. 
/ Ignore any null records in transfers of Intel hexadec¬ 

imal records. 

L Convert UPPER case letters to lower case letters. 

N Add line numbers to each line copied; lines end with 

the ASCII “CR” and “LF” characters produced by 
typing RETURN. 

O Ignore \Z end of file marker for copying non-text 
files. The O parameter is not necessary for copying 
“.COM” files. 

Pn Add a form feed (ASCII value OCH, or “FF”) after 
the nth line. 

Qstring\Z 

Copy portion of a file, stopping on string. If used on 
PIP command line rather than following PIP’s * 
prompt, the Q parameter looks for all UPPER case 
version of string ; otherwise, it looks for actual 

string. 

R Copy “system” files (with SYS attribute). 

Sstring\Z 

Copy portion of a file, starting on string. 

Tn Set tab stops at every nth column, so that f / (TAB 
key) characters are replaced with spaces to position 
the next character at column divisible by n. 

V Verify copy by comparing it with the source file. 

W Copy into a read-only file overriding read-only 

attribute. 

Z Set the unused 8th bit (parity bit) of each character 
to 0. 

STAT: System Statistics 

STATd: 

By itself, STAT tells you the space used and the 
available space on disk. With a disk drive prefix d.\ 
STAT tells you the space available on the disk in that 
drive. 
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\d:filename atr \ 

STA1 \dfilematch atr | 

Display size and attributes of filename or files that 
match filematch. You can change the attributes of 
one or more files by specifying one of the optional 
atr attributes below. A file can have two non-oppos¬ 
ing attributes. 

CP/M-80 Attributes: 

$R/0 Read-only: file can not be written to or erased. 

$R/W Read-write: opposite of $R/0 (default). 

$SYS System file: does not appear in DIR displays (you 
must use the [R] parameter with PIP to copy them). 
$DIR Directory file: opposite of $SYS (default). 

CP/M-86 Attributes: 

RO Read-only: file can not be written to or erased. 

RW Read-write: opposite of RO (default). 

SYS System file: does not appear in DIR displays (you 
must use DIRS to display them, and the [R] param¬ 
eter with PIP to copy them). 

DIR Directory file: opposite of SYS (default). 

STATUSR: 

Display user numbers. 

STAT d.DSK: 

Display disk information for current drive or drive 
d:. 

STAT d:=R/0 

Assign read-only attribute to disk d: (CP/M-80). 

STAT d:=RO 

Assign read-only attribute to disk d: (CP/M-86). 

STAT DEV: 

Display physical device assignments. 

STAT VAL: 

Display possible device assignments and STAT 
summary. 

STAT log:=phy: 

Assign physical device to logical device name. 

Logical Device Names: CP/M-80 

CON: Console display and keyboard for both input and 
output 

RDR: Reader device for input only 
PUN: Punch device for output only 
LST: List device (printer) for output only 

Logical Device Names: CP/M-86 

CON: Console display and keyboard for both input and 
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output 

AXI: Auxiliary input device (input only) 

AXO: Auxiliary output device (output only) 

LST: List device (printer) for output only 

Physical Device Names 

TTY: Slow CON: device (teletypewriter) 

CRT: Fast CON: device (cathode ray tube display) 

LPT: Line printer 

BAT: Batch processor 

PTR: Paper tape reader (RDR: device) 

PTP: Paper tape punch (PUN: device) 

UC1: User-defined (custom) CON: device 

UL1: User-defined (custom) LST: device 

UR1: User-defined (custom) RDR: device 

UR2: User-defined (custom) RDR: device 

UP1: User-defined (custom) PUN: device 

UP2: User-defined (custom) PUN: device 

SUBMIT Utility and XSUB 

SUBMIT d: filename parameters 

Create $$$.SUB to contain your commands in your 
filename. SUB, then execute the commands. Any 
parameters you include replace your arguments ($1, 
$2, etc.) in your submit file. Include XSUB as your 
first command in your “.SUB” file so that your com¬ 
mands/programs can query your console. 

SYSGEN: Copy System (CP/M-80) 

SYSGEN 

Place a copy of the system on disk. SYSGEN asks 
for the source drive of your system disk, and then the 
destination drives for your copies. Type RETURN 
to restart your system. CP/M-86 users: use COPY- 
DISK. 

Common Error Messages 

NO FILE or FILE NOT FOUND 

Disk does not contain file you specified. 

BDOS ERR ON d: 

No disk in drive, disk is not formatted, disk is so old 
that CP/M can’t read it, disk drive is not on, door 
not closed, or drive doesn’t exist, or you’re trying to 
write to a read-only disk. 

INVALID DISK ASSIGNMENT 

In a STAT command, you followed d: with some¬ 
thing other than = R/O (or = RO in CP/M-86). 

whatever you typed? 

If whatever you typed was repeated and followed by 
a question mark (?), it is probably a misspelled com¬ 
mand, or the filename you typed does not exist as a 
“.COM” file on the current disk. 0 
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Telecommunications and Videotex 


Using CompuServe 

An information service from H & R Block 


by Cheryl Rhodes & Tony Bove 


In this article we use THIS TYPEFACE for words you 
type, and This Typeface for messages and menus displayed 
on your screen while using CompuServe or other systems. 
The P symbol is used to show when to press the RETURN 
(or ENTER) key, and the f symbol shows when to use the 
CONTROL (CTRL, CNTL or ALT) key in combination 
with another letter (as in t C for CONTROL-C). 

For some desktop computer users, data communica¬ 
tions is the major reason for buying the computer. A comput¬ 
er can be much “smarter” than a “smart” terminal in 
communicating with large “host computers” and informa¬ 
tion services like The Source and CompuServe. 

Computer Communications 

Computers can be connected together, physically by 
cable or other means, to transfer data from one to the other 
(and back). You can also connect a computer to a telephone, 
and make a call to another computer also connected to a tele¬ 
phone, and exchange data as if the computers were having a 
conversation. 

Computer-to-computer conversations follow certain 
rules known as data communications protocols. Unfortu¬ 
nately there is no single standard for all computers; however, 
there are recognized standards adhered to by most computers 
and information services. CompuServe will listen and re¬ 
spond to your requests if your computer can transmit ASCII 
characters (most desktop computers use ASCII characters). 

What do you need for your computer to communicate? 
At minimum, you need a modem and a connecting cable 
known as an RS- 232-C cable or serial data port cable (usu¬ 
ally in the same package with the modem device). Ask your 
dealer to verify that the connections on each end of the RS- 
232-C cable match those expected by your modem and com¬ 
puter (if the computer is at home, bring its documentation 
with you when you decide to buy a modem). 

You must also equip your computer with a program to 
handle data communications. There are many fine programs 
available, but be aware that prices aren’t always tied to the 
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number of features. MODEM7, for instance, is available for 
the cost of the floppy disk you receive it on, and many CP/M 
user groups can help you “configure” it for your system. To 
get cost effective results from an information service like 
CompuServe, your modem software should have a “down¬ 
loading to disk” storage feature. 

To use the CompuServe service, you need a Compu¬ 
Serve account number and password. You can sign up at your 
local computer store, or contact CompuServe (an H & R 
Block Company) directly at: CompuServe Information Ser¬ 
vice Division, 5000 Arlington Centre Blvd., Columbus, OH 
43220 (614) 457-8650. 

Modems 

The term “modem” is short for “modulator/demodula- 
tor” which describes a device that changes computer signals 
into phone transmission signals and back again into comput¬ 
er signals. There are two kinds of modems: direct-connect 
modems that plug directly into your telephone line jack and 
require registration with the phone company, and acoustic 
coupler modems that have fittings for the handset of your 
standard telephone, and need no phone company registra¬ 
tion. 

What kind should you use? Direct-connect modems of¬ 
fer a better connection, with less errors in the transmitted 
data. Some direct-connect modems also offer automatic 
phone dialing, automatic phone answering, and other useful 
features. However, direct-connect modems are more expen¬ 
sive, and they supposedly require phone company approval 
(which is not hard to get). Although most homes and offices 
now use the modular jacks for “plug-in” extension phones, 
some direct-connect modems require special connectors, and 
some telephones (including pay phones) do not provide ac¬ 
cess to the line directly. 

Acoustic coupler modems are less expensive and do not 
require a special phone jack or phone company approval. 
Acoustic couplers transmit through your phone’s handset, 
and can be used with pay telephones and others without di- 
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rect access to the line. However, princess telephones and 
some home models may not fit properly in the coupler. 

Although acoustic coupler modems do not provide the 
features of direct-connect modems, they are adequate for 
communicating with the CompuServe service. 

Your modem should have its own instructions and set¬ 
tings. CompuServe expects you to communicate in “full du¬ 
plex” mode (a switch on your modem sets this mode) and at 
300 baud (approximately 30 characters per second, a Bell 
Telephone standard speed for acoustic couplers and most oth¬ 
er modems). 1200 baud service is also available (approxi¬ 
mately four times faster than 300 baud), but you must pay 
over three times more per hour. 

Acoustic coupler modems are connected to the tele¬ 
phone only when used to communicate (using the telephone 
handset), but direct-connect modems are usually connected 
to the phone line for indefinite periods. Some users dedicate 
one phone line for long- term modem connection and use. 

Communications Software 

You also need a program that transmits data through 
the serial data port (modem port) of your computer. There 
are a variety of such programs available for CP/M systems. 
We use the public-domain (free) MODEM7 program, which 
is available through users’ groups and from CP/M bulletin 
board systems, as well as some stores that sell modems (for a 
nominal charge). We have also used other excellent commer¬ 
cial programs that provide more features (AMCALL and 
COMMX on a variety of CP/M systems, and Micro-Link on 
the Osborne 01). We intend to compare these and other mo¬ 
dem programs in a future issue of The User's Guide. 

One problem for newcomers: the modem program you 
get should be already configured for your computer, and be 
supplied on your computer’s disk format. MODEM7 must be 
tailored for most systems, so you may want to purchase a cus¬ 
tomized version, or a commercial package (all will work with 
CompuServe). If your software cannot “download to disk,” 
you can still use the CompuServe service, but you cannot save 
the results, unless you set up your computer to print every¬ 
thing that happens on your screen (using the CP/M CON- 
TROL-P command). 

CompuServe’s Services 

CompuServe provides informative services like Stan¬ 
dard & Poor’s data base and the MicroQuote program to 
keep abreast of daily stock prices and financial transactions. 
CompuServe also offers the MicroNet personal computing 
service, instant “electronic mail” message delivery to any 
other user, an “electronic bulletin board” for messages to all 
users, and a “CB Simulator” that lets you “talk” (by typing 
messages) to any number of people over thirty-six different 
channels. 

CompuServe’s latest electronic offerings include bank¬ 
ing, shopping at home, several daily newspapers, AP world 
news, world weather, and special flight planning services for 
pilots of private planes. 

Some CompuServe services are quite expensive, and 
others are surprisingly inexpensive and very useful. As you 
learn more about CompuServe, you will also learn to be more 
thrifty with the service. CompuServe offers a free first hour 
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to all users. Use it wisely to learn about the system and how to 
avoid the high costs of some services. 

Starting a CompuServe Session 

A CompuServe account consists of a unique ID num¬ 
ber and secret password. CompuServe uses the number to 
keep track of your use of the information service and to 
charge you for certain services. You use the secret password 
to “log on” (turn on the services) with your unique ID 
number. 

Keep your password secret, so that someone else cannot 
use your number without your help (otherwise, you’d have to 
pay the charges). You can change it as often as you like by 
typing GO CIS-175 and following the instructions. Don’t use 
your name or initials as your password, since someone could 
easily guess them. 

Most CompuServe accounts give you permission to use 
the service between the local hours of 6PM to 5 AM weekdays 
and all day Saturday, Sunday, and holidays. Business ac¬ 
counts may use CompuServe during regular business hours, 
but the service is far more expensive during these peak hours. 

You can look up the CompuServe number for your local 
area using the list of phone numbers provided. The phone 
numbers marked “C” in the list are direct lines to the Com¬ 
puServe computers. CompuServe adds more of these direct 
lines as the number of subscribers grows. 

Others (marked “T” on the list) are lines through a 
supplemental network known as Tymnet. To access Compu¬ 
Serve through Tymnet, you pay an extra $2 an hour (in addi¬ 
tion to CompuServe’s $5 per hour). However, some areas 
have only Tymnet numbers. Using a local Tymnet number 
may be less expensive than using a long-distance Compu¬ 
Serve number. All numbers are available for use by all users. 
You should choose a 300 baud number if you are using a 300 
baud modem, or a 1200 baud number if you are using a 1200 
baud modem. 

Calling CompuServe Through Tymnet 

Turn on your modem and computer, start your modem 
program, and dial your local Tymnet number. Listen (while it 
rings and after Tymnet answers) until you hear a high-pitch 
whine signaling data transmission. If you are using an acous¬ 
tic coupler, place your telephone handset firmly in the cou¬ 
pler; if you’re using a direct-line modem, set it for data 
transmission (some have a “data” switch to set). 

If Tymnet doesn’t immediately recognize your terminal 
or computer signal, the following message should appear on 
your screen: 

PLEASE TYPE YOUR TERMINAL IDENTIFIER 

If the message is garbled, check your modem’s setting 
and set it to “Full Duplex” and “300 baud.” If you still do not 
have a coherent message as shown above, hang up and try 
calling Tymnet again. Make sure you are dialing a 300 baud 
phone number if you are using a 300 baud modem. 

CompuServe customers who live outside Ohio can call 
(800) 848-8990 from 8:30 AM to midnight (Eastern Day¬ 
light or Standard Time) for assistance. From within Ohio or 
outside the continental U.S., call (614) 457-8650 for help. If 
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a human doesn’t answer, you will be able to leave a taped 
message (do not reveal your password if you decide to leave a 
taped message). 

With the above message on your screen, type the letter 
“A” (this is the most popular terminal identifier). Tymnet 
responds with another message: 

PLEASE LOG IN 

Respond by typing the CompuServe “log-in” word: 

C\SP 

At this point Tymnet performs the CompuServe “log 
in” key sequence, the CONTROL-C sequence, so you don’t 
have to type it yourself. You should see a |C displayed on 
your screen, followed by the CompuServe User ID: mes¬ 
sage shown below. If you don’t see the User ID: message, type 
a CONTROL-C command (hold down your CONTROL 
key and type C). 

Calling CompuServe Directly 

Turn on your modem and computer, start your modem 
program, and dial your local (or long-distance) CompuServe 
number. Listen (while it rings and after CompuServe an¬ 
swers) until you hear a high-pitch whine signaling data trans¬ 
mission. If you are using an acoustic coupler, place your 
telephone handset firmly in the coupler; if you are using a di¬ 
rect-line modem, set its switches for data transmission. 

With the modem set for data transmission (or tele¬ 
phone handset firmly set in the coupler), hold down your 
CONTROL key and type C The CONTROL-C command 
should appear on your screen as |C, and after a second or 
two, the following message should appear on your screen: 

User ID: 

If the message is garbled, check your modem’s setting 
and set it to “Full Duplex” and “300 baud.” Try the CON- 
TROL-C key sequence again. If the message is still garbled 
(or if there is no message), try calling CompuServe (make 
sure you are dialing a 300 baud phone number, if you are us¬ 
ing a 300 baud modem) again. 

Logging On to CompuServe 

With the above message on your screen, type your user 
number, usually a five-digit number, followed by a comma, 
another three-digit number, and the RETURN key: 

User ID: 00000,000P 

CompuServe should respond with the following 
message: 

Password: 

Type your secret password and press your RETURN 
key. You will not see your password as you type it! It is invisi¬ 
ble for your protection (to keep others from seeing it as you 
type it). 


If you misspell your password, CompuServe will print 
the following message and give you a second try: 

?? LOGINE - Invalid entry - try again 

If you typed your password correctly, you will be wel¬ 
comed into the CompuServe network. 

Using The System 

On your first call to CompuServe, you will be asked to 
sign up for continued services. Do so immediately, since you 
have only one free hour before you lose the account otherwise. 
When a menu with numbered choices is displayed, Compu¬ 
Serve tells you to “key” a number, which means type the 
number you want and press the RETURN key. 

CompuServe tells you to press your ENTER key, which 
is a reference for Radio Shack computers and terminals 
whose ENTER keys function as Carriage Return/Line Feed 
(known as RETURN). In other words, CompuServe’s EN¬ 
TER key is the same as the typical RETURN key on com¬ 
puters that run CP/M. 

CompuServe asks for personal billing information, in¬ 
cluding your complete name and address, your Mastercharge 
or VISA card number (to bill you directly for CompuServe 
charges), and the expiration date of your card. Answer each 
question by typing an answer and pressing your RETURN 
key. 

If you charge the service to your VISA or Master- 
charge card, CompuServe charges are detailed on your usual 
VISA or Mastercharge monthly statements, and you do not 
get a separate statement from CompuServe. 

If you don’t want to pay by VISA or Mastercharge, 
CompuServe will bill you directly or you can establish credit 
with VIP, but you pay extra for the statements CompuServe 
sends you regularly. To find out more about the VIP account, 
write to: CompuServe VIP Account, Attn: Kathy Gallagher, 
Box 629, Dept. 0585, Columbus OH 43271. 

If you want to use CompuServe during business (day¬ 
time) hours, you should first establish service as a personal 
(evening) user. There is a minimum monthly charge of 2 
hours per month (2 HOURS = $45 for 300 baud, $70 for 
1200 baud) on daytime accounts. There is no monthly mini¬ 
mum for evening service. 

At the end of your sign-up session, CompuServe dis¬ 
plays a page of “what’s new” in the service, and in a moment 
you’ll be given a chance to go directly to these topics. Skip to 
the next CompuServe page by pressing your RETURN key. 
The TOP menu page of selections should appear: 

CompuServe Page CIS-1 

CompuServe Information Service 

1 Home Services 

2 Business & Financial 

3 Personal Computing 

4 Services For Professionals 

5 User Information 

6 Index 

Enter your selection number, 
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or H for more information. 

! 

CompuServe’s menus consist of a page showing selec¬ 
tions and an exclamation point (!), called a prompt , telling 
you that CompuServe is now “listening” and awaiting your 
typed response. 

You can select an item by typing its number and press¬ 
ing the RETURN key, or you can simply press RETURN to 
see the next page of information. You can also type H for 
help, followed by the RETURN key, to get the following 
summary of CompuServe commands: 

\HP 

Brief Command Summary 

**¥*¥*******************¥*** 

T - TOP menu page 
M - previous MENU 
F - FORWARD a page 
B - BACK a page 
H - HELP 

R - RESEND a page 
S n - SCROLL from item “n” 

G n - GO directly to page “n” 

N - display NEXT menu item 
P - display PREVIOUS menu item 
KEY S OR (ENTER) TO CONTINUE 

i 

You can see the next page of information by pressing 
the RETURN key, and you can read page by page by press¬ 
ing RETURN each time you reach the end of a page. You 
can also “scroll” more quickly through pages by typing S at 
the end of a page. You may reach the end of a set of pages and 
see the following message: 

Last page. Key M for menu 

At this point, you can type an M followed by RETURN 
to go back to the TOP menu page shown previously, or you 
can type the following command (a good idea if this is your 
first time on the system today) to see what’s new on the 
system: 

!GO NEWP 

The GO command (or type G) lets you move directly to 
almost any page in the CompuServe data bases. You can use 
the GO command from any menu page to go quickly to any 
other page if you know either the data base name or the page 
number. 

Names of data bases are available if you type H (or 
HELP), followed by the RETURN key, and scroll through all 
the messages. Each page in each data base has a page name 
and number in its upper right corner. We show CompuServe 
menus with the page numbers they occupied in September, 
1982 (how often they change pages and menus is an ongoing 
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mystery; they are trying to incorporate data base supplier 
and subscriber feedback for an easy to use and constantly ex¬ 
panding service). 

You can select items from menus to get to any page in 
the CompuServe data bases and never use the GO command; 
however, users who want to save time (and money) can use 
the GO command to move to specific pages. 

With the GO command you type a page number or just 
the name of the data base (the name of the “what’s new” data 
base is NEW). The preceding GO NEW command displays 
the WHAT’S NEW menu shown below. 

CompuServe Page NEW-1 

***** WHAT’S NEW ***** 

Current Week’s Announcements 

****************************** 

1 SOFTWARE SIG CONFERENCE 9-8-82 

2 SPECIAL CONFERENCE FOR 9-4-82 

3 COMP-U-STORE - BACK TO SCHOOL 

4 NEW NUMBERS IN NC, CA, CO 

5 LABOR DAY HOURS STILL THE SAME 

6 UAB OFFERS ACCESS TO EVERYONE 

Input a number or key 

(ENTER) for more choices 

! 

You can select an item by typing its number, followed 
by RETURN. This will give you the item’s pages one at a 
time (you have to press RETURN for the next page). 

You can also select an item and scroll through the pages 
by typing S, a space, the number of the item, and the RE¬ 
TURN key. The S command saves time by scrolling pages 
without asking for a response from you. Once you’ve located 
the menu you’re looking for, use the S n command to select 
an item and scroll through its pages. 

To return to the WHAT’S NEW menu, type an M fol¬ 
lowed by the RETURN key. Another M command from the 
WHAT’S NEW menu page will put you in the previous menu 
(the TOP menu). 

The TOP menu shows the major selections in the Vi¬ 
deotex service, as well as the MicroNet Personal Computing 
selection for the computing service. You can pick any Video¬ 
tex selection and explore the possibilities of, say, home ser¬ 
vices or financial services and still return to the TOP menu 
by using the T command followed by RETURN. 

Financial Services 

If you are using CompuServe for financial business, 
you won’t want to waste any time: select number 2 from the 
TOP menu to get this menu of selections: 

CompuServe Page FIN-1 

BUSINESS AND FINANCIAL SERVICES 

1 News/Reports 

2 Reference Databases 
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3 Communications 


\2P 


Last menu page. Key digit 

or M for previous menu. 

! 

For financial news and reports, select number 1: 

HP 

CompuServe Page FIN-10 

********** NEWS/REPORTS *********** 

1 Business Information Wire 

2 The Business Wire 

3 MMS Financial Analysis 

4 Commodity News Service 

5 Archer Commodity Report 

6 Stevens Business Reports 

7 Investor Protection Report 

8 Investment News and Views 

9 Raylux Investors’ Reports 

Last menu page. Key digit 

or M for previous menu. 

! 

The newest menu item in this list is the Business Infor¬ 
mation Wire service from Canadian Press (a cooperative of 
111 daily Canadian newspapers, founded in 1911), which 
carries news stories under 18 categories (like agriculture, 
banking, economy, environment, forestry, manufacturing, 
mining, transportation, etc.). International news is provided 
by the Associated Press, Reuters and Agence France-Presse. 
An historical data base called Newstex dates back to January 
1974, and contains about a million stories. 

Like most other CompuServe business and financial 
data bases, the BIW service costs extra ($5) per hour of con¬ 
nect time during standard (evening) hours. Daytime sub¬ 
scribers pay an extra connection fee of $22.50 per hour, plus a 
monthly subscription fee of $50. 

When you are using the expensive data bases, to get the 
most for your money you should use modem software that has 
downloading capabilities to capture the data on your screen 
and store in on your disk, or print it. With the data on your 
disk, or a printed copy available, you can reduce reduce the 
time you spend connected to the CIS computers. 

By typing an M (followed by RETURN) from within a 
report or financial news feature, you return to the menu 
above that pointed you to the report or news feature. By typ¬ 
ing an M (followed by RETURN) again , you return to the 
previous menu — BUSINESS AND FINANCIAL SER¬ 
VICES — the one that pointed you to the menu of financial 
news features and reports. 

From the BUSINESS AND FINANCIAL SERVICES 

menu, you can select the REFERENCE DATABASES (num¬ 
ber 2): 


CompuServe Page FIN-20 

******** reference DATABASES ****** 

$ 1 MicroQuote 
$ 2 Quick Quote 
$ 3 Standard and Poor’s 
$ 4 Value Line Data Base II 
5 Descriptions and Premium 
Program Rates 

$ Indicates Premium Program 
Last menu page. Key digit 
or M for previous menu. 

i 

MicroQuote, for an extra charge to your CompuServe 
account, will give you current and historical data on 
40,000+ stocks, bonds and options including NYSE prices, 
AMEX prices and OTC stock prices. Select item 1 from the 
above menu for MicroQuote, but first you should order the 
MicroQuote User’s Guide ($4.95, Order Code: CS-447) 
from FEEDBACK (type G C/S- 4). 

Standard & Poor’s “premium” data base (item 3) con¬ 
tains financial statistics and other information about 3000 + 
publicly held corporations. For more information, write to: 
Standard and Poor’s Corporation, 25 Broadway, New York 
NY 10004. 

Home Services 

CompuServe’s home services include electronic mail 
and the CB Simulator (with the Communications selec¬ 
tion), games (with the Entertainment selection), newspa¬ 
pers, home management programs, special services like 
national weather for the public, or marine and aviation 
weather data, or ski-slope weather forecasts, etc. To get the 
HOME SERVICES menu, select number 1 from the TOP 
menu: 

\1P 

CompuServe Page HOM-1 

HOME SERVICES 

1 News/Weather/Sports 

2 Reference Library 

3 Communications 

4 Shop/Bank at Home 

5 Groups and Clubs 

6 Games and Entertainment 

7 Education 

8 Home Management 

The News/Weather/Sports menu (page HOM-10) 
gives you access to The Columbus Dispatch , The Washing¬ 
ton Post , the St. Louis Post-Dispatch , the NOAA Weather 
Wire, and the PGA Golf Data Base. 
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Name 

Topic 

ACR 

Archer Commodities 

Financial 

AJC 

Atlanta Journal 

Newspaper: Atlanta GA 

APN 

AP Wire Sports News 

News 

ASI 

Aviation Safety Institute 

FAA reports 

ATR 

Atari Newsletter 

Manufacturer’s newsletter 

BHG 

Better Homes and Gardens 

Nutrition, meal planning 

CBM ’ 

Commodore’s Information Network 

Manufacturer’s newsletter 

CDP 

Columbus Dispatch News 

News summary: Columbus OH 

CIS 

CompuServe’s Main Menu 

CompuServe’s Top (see T in CIS command summary) Menu 

CNS 

Commodity News Service 

Financial, Inti, weather, news 

cus 

Comp*U*Star 

Shopping at home 

CVP 

CompuServe Viewpoint 

Videotex views, Filge (File generator and editor) instructions 

EMA 

Electronic Mail 

Electronic messaging 

FED 

Investor Protection Report 

Financial 

FIN 

Futures Industry News 

Financial services main menu 

GAN 

GandolFs Fashion Report 

Clothing design news 

GPO 

Government Publications Office 

Consumer news, tips 

HOM 

Home Information 

Home services main menu 

IND 

Index 

CIS index, AP world, financial news access 

INV 

Investment News & Views 

Financial commentaries 

LAT 

Los Angeles Times 

Newspaper: Los Angeles CA 

MCS 

MicroSoft News 

Manufacturer’s newsletter 

MDN 

Middlesex Daily News 

Newspaper: Framingham MA 

MMS 

MMS Financial Analysis 

Financial: Securities Info., Fedwatch newsletter 

MST 

Minneapolis Star Tribune 

Newspaper: Minneapolis MN 

NEW 

What’s New 

New services on CIS 

NYT 

New York Times 

Newspaper: New York NY 

PCS 

Personal Computing System 

Personal computing services main menu 

PEM 

Popular Electronics 

Personal electronics computer club news 

PSC 

Popular Science 

Magazine 

PSE 

Popular Science, Energy 

Magazine 

PSP 

Popular Science, Photography 

new product news, software reviews, satellite TV news 

RBO 

Business Outlook 

Financial 

RCA 

RCA News 

Manufacturer’s Newsletter 

RFC 

Financial Commentaries 

Financial 

SBR 

Stevens Business Reports 

Financial: small business reports 

SFC 

San Francisco Chronicle 

Newspaper: San Francisco CA 

SFE 

San Francisco Examiner 

Newspaper: San Francisco CA 

SPD 

St. Louis Post Dispatch 

Newspaper: St. Louis MO 

TCB 

The College Board 

choosing a college, financial aid, adult ed., SAT test info 

TFF 

The Future File 

News features and interviews on computing, bio-engineering, 
telecommunications, etc. 

TMA 

The Micro Advisor 

Micro news, software reviews 

TMC 

The Multiple Choice 

Quizzes for enjoyment/learning for adults: also, TMC-27 for kids 

TRB 

The Refundle Bundle 

manufacturer’s coupon refund and “freebies” newsletter 

TRS 

Tandy/Radio Shacks News 

Manufacturer’s newsletter 

TWP 

The Washington Post 

Newspaper: Washington DC 

VIF 

Video Information 

Video newsletter for professionals 

VPL 

Virginian-Pilot & Ledger Star 

Newspaper: Virginia 

WEA 

Weather Reports, National 

NOAA aviation, marine and land weather (see CNS-17 for Asian, 
African, European, N. American, and S. American weather) 
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The Communications selection (page HOM-30) gives 
you several user-to-user communications facilities: Electron¬ 
ic Mail for sending a message to another user, the CB Simu¬ 
lator for “talking” with one or more users (simulating 
Citizen Band radio channels), and the National Bulletin 
Board for posting and reading messages. 

Lobby Letters of America offers a service to send let¬ 
ters to members of congress and other federal officials and 
agencies, as well as national corporations, organizations, 
products and services, national TV stations and shows, news¬ 
paper and magazine editors, and foreign leaders and offi¬ 
cials. 

The Reference Library menu (page HOM-20) offers 
Better Homes & Gardens , movie reviews, Popular Science , 
The Refundle Bundle, U.S. Govt. Publications, the Pan 
American Travel Guide and other periodicals and “videotex 
magazines.” Health-Tex, a “magazine” from the Health Re¬ 
sources Corp. of America, offers information and health tips 
on a variety of medical topics. It even has an “emergency” 
mode that offers information on poison antidotes, resuscita¬ 
tions and first aid. 

The Shop/Bank at Home menu (page HOM-40) of¬ 
fers the ability to purchase goods at the COMP-U-STORE, 
order cassette tapes of popular National Public Radio pro¬ 
grams (NPR Cassette Gazette), purchase computer 
graphics printouts (Art Gallery) and bank electronically. 

You can do your banking electronically (Tell-A-Pay 
bill payment service, or view current checking/savings ac¬ 
count statements) with Financial Interstate Services Corp. in 
Knoxville Tennessee (call (615) 637-2035 for an ID num¬ 
ber). The United American Bank of Knoxville (615) 971 - 
2265, and the United American Bank of Memphis Tennessee 
(901) 766-2717 are participating in this electronic banking 
service. 

A demonstration of home banking begins on page 
HOM-6. Although the home banking service was initially 
limited to those customers using TRS-80 Color Computers, 
it has recently been expanded to include most other micro¬ 
computers as well. 

The Groups and Clubs include clubs for HAM radio 
hobbyists, “CB Simulator” users (CBIG), and other special 
interest groups such as those interested in sports, photogra¬ 
phy and music (Photo-80/0rchestra-80), gourmet cooking 
(hosted by Better Homes and Gardens staff), and even a 
group with an interest in networking (Netwits). 

NOTE: Computer clubs and user groups are not 
listed here. For computer-related information, clubs, 
newsletters and user groups, try the Personal Computing 
Service menu. 

COMPUSERVE PAGE HOM-50 

GROUPS AND CLUBS 

1 CBIG 

2 HAMNET 

3 NETWITS 

4 PHOTO-80 

5 SPORTS 

6 COOKS’ UNDERGROUND 

7 BELMONT’S GOLF SIG 


8 INSTRUCTIONS 

9 DESCRIPTIONS OF GROUPS 

Professional Services 

At this time, CompuServe offers a flight planning ser¬ 
vice, a newsletter, a wire service and a special interest group 
(AVSIG), all for amateur and professional aviators. A health 
care special interest group also appears in the Services For 
Professionals menu, and we assume that more services will 
become available for other professionals. 

\4 

CompuServe Page SFP-1 

Services For Professionals 

Aviation 

1 ASI Newsletter 

2 NOAA Weather Wire 

3 AVSIG 

4 EMI Flight Plans 
Medical 

5 Health Care SIG 

EMI flight planning is based on aircraft navigation 
where pilots fly with radio signals from VORTAC stations. 
Navigators without special RNAV (area navigation) equip¬ 
ment must plan routes that pass over or near these stations 
(to maintain radio contact), whereas navigators with RNAV 
equipment can create “synthetic” VORTAC stations and 
possibly fly shorter distances. The EMI flight planning ser¬ 
vice is useful for pilots whether or not they have RNAV 
equipment. Pilots with RNAV equipment use the EMINAV 
flight planning, and pilots without the special equipment use 
the EMIVOR planning. 

The programs also provide the two most recent weather 
reports for the origin and destination, and the most recent 
forecast for those locations, including the winds at selected 
altitudes and information on severe weather. 

Data Bases 

To help you find a specific data base without going 
through a long series of menus, we have compiled a table of 
data base acronyms (3 letter abbreviations). Type G XXX 
(substitute a specific data base acronym for XXX) at any ! 
menu prompt to go to the desired data base. 

CompuServe adds new data bases often, so there may 
be more than we have listed here. Since some CompuServe 
page numbers change frequently, you don’t need to give a 
page number with the G(o) command. You will go to the top 
menu of the desired data base if you don’t specify a page. 

We have unfortunately run out of space. The Compu¬ 
Serve Personal Computing System, useful for running pro¬ 
grams on CompuServe’s DECsystem-10 and DECsystem-20 
minicomputers, will be covered in a future article. It is rec¬ 
ommended that you buy the manuals before using the Per¬ 
sonal Computing System services. Select Feedback from 
the User Information menu to order these manuals and any 
other documentation. 0 
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ASTATp ... by Kelly Smith 


Preventing Computer Disasters 

System care, feeding and preventive maintenance 






EjU 




Watch the A)STATP column 
for tips, opinions, rumors and maybe 
even some facts from the ever-re- 
sourceful Kelly Smith, system opera¬ 
tor (SYSOP) of the infamous CP/M- 
Net system (a remote bulletin board 
and free software exchange for 
CP/M® users). Kelly brings you the 
collective wisdom of thousands of 
CP/M-Net callers and users. The 
phone number of his system is 805- 
527- 9321, and keep trying!! 

This article tells how to avoid 
disasters with your micro system, and 
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how to recover from the brink of data 
annihilation. I feel qualified to give 
this advice, having poked, fiddled and 
thrashed around with systems for 
about five years. The advice is general 
enough to apply to almost any make 
and model microcomputer, and par¬ 
ticular enough to provide the essen¬ 
tial details that will keep your 
computer happy and you content. 

The 


Power Input: a Proper Diet 

Consider carefully the power 
source for your system. If possible, 
use a 3-wire (protective ground) out¬ 
let that has a 15 Amp (or more) pow¬ 
er capacity that is directly connected 
to your home main circuit breaker. It 
is ideal to have this circuit on its own 
breaker, isolated from the rest of the 
utility outlets used for the various ap- 
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pliances in your home or other ma¬ 
chines in your office. 

Your circuit breakers or fuses 
may be marked as to which breaker 
services which room. To find such an 
outlet, you can use a small lamp as a 
voltage indicator. Turn off all but one 
of the circuit breakers to your home, 
and plug the lamp into the outlet you 
want to use for your computer. If it 
does not light, turn the circuit break¬ 
er off and try another until you locate 
the one that services the outlet you 
want to use. 

Make sure the power has a di¬ 
rect and isolated path to your system. 
After you’ve isolated the path, plug 
the lamp into the remaining power 
outlets, making note of what else is on 
the power line. This is very important, 
because you need to remove (or at 
least minimize) the number of “pow¬ 
er hogging” and “glitch producing” 
appliances attached to your system’s 
power line. 

Some examples of “power hog¬ 
ging” appliances are electric heaters, 
electric ovens, stoves, refrigerators 
and toasters. One or more of these ap¬ 
pliances can drop the available input 
line voltage to as little as 80 VAC or 
less. Low line voltage (especially with 
typically non-regulated microcom¬ 
puter power supplies) will cause a lo¬ 
calized “brown-out” effect in your 
system. This “brown-out” may not be 
readily apparent to you because other 
appliances around your home (e.g., 
radios, televisions, florescent light¬ 
ing) may be perfectly happy working 
in this situation. 

What about the “glitch-pro¬ 
ducing” appliances that are lurking 
quietly, waiting for the precise mo¬ 
ment to raise havoc with the comput¬ 
er? They have the potential for not 
only spurious problems that clobber 
your work disk (and possible hours of 
work), but expensive damage to your 
system! 

Remember this rule: if it has a 
motor in it, avoid it! Don’t have mo¬ 


tors on the same circuit as your sys¬ 
tem. “Glitch-producing” devices 
include refrigerators, air condition¬ 
ers, washers and dryers, electric type¬ 
writers... in short, any devices with 
motors or solenoids. These appliances 
provide a double edged problem: 
When turned on, they can cause the 
“brown-out” effect, and in addition, 
put transient voltages (sometimes on 
the order of hundreds of volts) into an 
otherwise “clean” AC power line. Al¬ 
though these transient voltages are of 
short duration, they can show up in 
your computer’s power supply and 
create havoc. 

Many of the components in your 
computer are extremely sensitive to 
any sudden high voltage, which can 
“zap” your system and cause it to per¬ 
form in strange ways. However, you 
may not notice these strange wonders 
for days and possibly weeks after the 
high voltage “zap” condition has 
passed! I had an IMSAI that suffered 
the voltage “Wrath of ZEUS,” and 
bad IC components appeared daily 
for almost three months afterward! 
So track down these “glitch produc¬ 
ers” and remove them from your sys¬ 
tem’s power circuit. 

Some small and innocent-look¬ 
ing appliances may also cause prob¬ 
lems. Automatic heat-regulating 
soldering irons (often used next to a 
microcomputer) will “pop” the AC 
power line with voltage spikes that 
may not cause severe damage, but 
may cause erratic operation of your 
computer (e.g., bad disks or bad 
memory). 

Transient voltage suppression 
devices are available to wire directly 
into the AC input of your microcom¬ 
puter’s power supply, or can be pur¬ 
chased “built-in” to a power outlet 
box. Be warned however, that they are 
limited in “trapping” various combi¬ 
nations of transient voltage, duration 
and frequency, and they are expen¬ 
sive. You are better off getting rid of 
trouble at the source rather than try¬ 


ing to rid your microcomputer of 
“glitches” after the fact. 

Lightning strikes — from the 
incoming AC power line and from the 
telephone system — are an additional 
hazard to your microcomputer. If you 
are using a direct connect modem 
(such as the D.C. Hayes or PMMI 
modems), you would be wise to dis¬ 
connect them during the onslaught of 
a really good lightning storm. I know 
of two systems in the midwest (Ca¬ 
lamity Cliffs Computer Center, and 
Technical CBBS), that have had re¬ 
peated “hits” on their systems, and 
each time literally destroyed the tele¬ 
phone couplers attached to their sys¬ 
tems! 

S-100 Buss Systems 

Many S-100 buss systems are 
especially prone to the localized 
“brown-out” effect, because the non- 
regulated (read “cheap to manufac¬ 
ture”) power supply (which provides 
+ 8 VDC and + -16 VDC to the sys¬ 
tem’s mother-board buss) is regulat¬ 
ed separately on each board in the 
computer. 

The individual boards regulate 
the +5 VDC, and +-12 VDC re¬ 
quired by their integrated circuits 
and components. These regulators re¬ 
quire (at a minimum) 3 volts of “head 
room” for proper operation (i.e., the 
on-board integrated circuits use +5 
VDC and therefore require a “raw” 
input to the regulators of +8 VDC). 

You can measure the voltage 
with a low cost voltmeter purchased 
from your local electronics or hard¬ 
ware store. Nothing fancy required 
— any meter in the $10 to $15 cate¬ 
gory will be fine. Refer to the manu¬ 
facturer’s details on the layout of each 
board for the regulator input/output 
(and ground) pin assignments, and 
follow the “three volt rule” to deter¬ 
mine if your computer is being fed the 
proper diet of raw input voltage (mea¬ 
sure directly at the INPUT and 
GROUND terminals). 


The User's Guide #1 © 1982 TUG Inc. 


Page 51 


Be aware that the DC voltage 
value may appear to be correct, but 
due to poor power supply filtering in 
your “raw” supply, may have an AC 
composite voltage (called a “ripple”) 
that “droops” below the head-room 
required by the individual on-board 
voltage regulators. Again using your 
inexpensive voltmeter, switch to the 
lowest AC voltage range possible, and 
measure the input voltage once more. 

Any measurable voltage means 
potential trouble, with the effect of 
“mini-brown-outs” every half-cycle 
of the AC line voltage (8.3 millisec¬ 
onds for a 60 cycle input). 

Keep in mind that your micro¬ 
computer will be executing instruc¬ 
tions at the rate of millions per 
second. Eight milliseconds is a con¬ 
siderable amount of execution time to 
your system, and the system must not 
screw up even once. Murphy’s Law of 
Frapped Program Execution states 
that “one bad instruction will modify 
other instructions (also known as The 
Avalanche Effect) and will always 
occur after four hours of editing a 
program, with no backup file!” 

What can you do if you find 
trouble with the input power voltage? 
(1) Find an AC input line voltage 
source that is solid (i.e., really is 115 
VAC), (2) purchase a pre-regulated 
(expensive) power source, or (3) give 
up now! There is no hope ahead for 
trouble free operation of your system, 
just frustration. 

Note: some S-100 buss micro¬ 
computer systems (notably the MITS 
Altair 8800b computer) allowed the 
user to “tune” the unregulated power 
supply voltage by changing the power 
supply’s transformer AC input volt¬ 
age “taps” to boost the output volt¬ 
age. This was done to accommodate 
the installation of additional boards 
(usually more than six) in the already 
power starved Altair. Check your sys¬ 
tem’s hardware manual to see if it is 
possible to “tune” your system for a 
low line voltage situation. 

A word of caution here: if the 
line voltage does recover and input 
more than nominal voltage, or you 
move the computer to some new loca¬ 
tion that has a solid line voltage, those 
same voltage regulators may have too 
much “head room” and must get rid 
of this extra input voltage in the form 
of heat. Computer components de- 
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grade drastically with any rise in tem¬ 
perature (beyond their normal power 
ratings), and will surely succumb to 
an early death. Watch out — on¬ 
board filter capacitors tend to turn 
into resistors at elevated tempera¬ 
tures and burst into flames (yes, catch 
fire). Of course, heat is another prob¬ 
lem. 

Keeping Your Microcomputer 
Cool 

Perhaps the worst offender in 
keeping component devices from run¬ 
ning hot in your microcomputer is the 
cooling system itself, or lack of it. If 
you have a fan, the foam filters that 
cover the fan inlet are trying to pro¬ 
vide not only cool air, but clean air. 
Dust and dirt has to go somewhere, so 
where else but the filter? That’s 
where the crud stays. 

If you’re as (gulp) tidy as I am, 
you should do what I do: throw’em 
away! Sure, dirt and dust will be 
sucked into the computer, but if your 
fan is working properly, most of it will 
also be blown out It is much better to 
let the internals get a little dusty than 
to forget to remove and clean the fil¬ 
ter once a month. 

Alright, now you will always 
have cool air blowing into the micro¬ 
computer. But is the cool air cooling 
anything? With the cover off of your 
computer, light a match and blow it 
out, and immediately place it six to 
eight inches downstream from the in¬ 
coming air flow. Where does the 
smoke go? On some systems, the 
smoke shows that the cooling air goes 
right out the vent holes next to the 
fan! If this is so with your system, 
block the vent holes with some duct 
tape and cardboard. 

Try the smoke test again. Is the 
flow of air actually blowing through 
the boards in your system? If not, use 
more duct tape and cardboard and 
channel the airflow directly into the 
boards. It may not look very sophisti¬ 
cated, but once you put the cover back 
on, who’ll notice? 

You may have to be clever and 
design a good airflow system into 
your microcomputer. Cooling always 
seems to be an afterthought in many 
of the “boxes” that I have seen. The 
IMSAI 8080 chassis has the power 
transformer parked directly in front 
of the fan blocking the airflow. How- 
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ever, with a little work (and duct tape 
and cardboard), it runs pretty cool 
even with fifteen cards in the system. 
Another method to try, if the duct 
tape and cardboard is inadequate, is 
to un-bolt the fan, pull it out of the 
chassis, and put it in backwards to 
blow air through the system. 

Some microcomputers rely on 
convection cooling alone to keep cool 
(e.g., Apple II, Osborne 01, etc.). If 
the temperature is warm on the out¬ 
side, count on it being 10 to 20 de¬ 
grees hotter on the inside. The point 
here is: keep the room that your mi¬ 
crocomputer is in cool — about 70 de¬ 
grees is comfortable for the internals. 
Avoid placing your system in a place 
where it gets direct sunlight, or if it’s 
in a cabinet with additional peripher¬ 
al parts of your system (especially 
disk drives), mount it underneath all 
that stuff (remember, hot air rises). 

Also, keep your microcomputer 
clear of floor heat ducts. They may 
help keep your toes toasty on cold 
winter nights as you sit in front of 
your terminal, but they can cause 
heat damage to your computer. 

Radiated Disaster: Sources 
and Situations 

You know about radiated heat 
doing nasty things, but have you con¬ 
sidered all the potential sources (and 
types) of radiated energy that cause 
us computerists grief? Consider a 
telephone, such as the one you use 
with your modem to communicate 
with other systems. It seems to make 
a neat “bookend” to lean a stack of 
floppy disks against, right? Wrong!! 
The bell in Ma Bell’s device is magne¬ 
tically driven. 

Read the back of one of the pa¬ 
per sleeves used to hold your floppy 
disks (What?? You don't keep them 
in their sleeves when you’re not using 
them? Argh!). Even if you don't like 
to read , the graphics provide some 
pretty good clues. For example, see 
the giant magnet crossed out as dan¬ 
gerous? Your telephone has one in¬ 
side it. (Why they put the “do’s and 
don’ts” on the back of the floppy disk 
sleeve, I’ll never know.) 

Of course, the microcomputer 
itself is a good source of magnetic en¬ 
ergy, especially if it is enclosed in a 
plastic case. Most of the magnetic en¬ 
ergy comes from the transformer in 
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the power supply. Keep your disks 
away from this area of your system. 

Some computer terminals also 
radiate magnetic energy that is 
strong enough to erase a floppy disk. 
It is an extremely bad practice to lay 
floppy disks on top of your terminal. 
The terminal’s fly-back transformer 
and CRT yoke can radiate enough en¬ 
ergy to cause flakey disks. 

One bizarre source of magnetic 
damage is the X-Ray machine at the 
airport. The x-rays themselves will 
not clobber a disk, but the magnetic 
field used to focus the x-rays sure will! 

On the other hand, EPROM 
(Erasable Programmable Read Only 
Memory) components don’t mind 
magnetic fields, but the x-rays are ex¬ 
cellent for a quick erase job! Hand 
carry these items and don’t allow 
them to be x-rayed. I mark my boxes 
of disks for mailing with “DO NOT 
X-RAY! MAGNETIC MEDIA 
INSIDE.” 

By the way, do you live near an 
airport or industrial area where radar 
is used? High energy pulses of power 
can travel many miles to clobber your 
system. You know when this is hap¬ 
pening, because you can set your 
watch by the time sweep of the dish 
antenna that “blips” your system. Al¬ 
though this is a rare situation for most 
home environments, it does happen 
(twice to me so far!). 

Finally, there is the all-too-fa- 
miliar static discharge. You’ve felt it 
— that spark you create by casually 
rubbing your feet on the carpet before 
touching the keyboard? The sudden 
sickening “oh no” feeling when 
WordStar® just... goes away? 

If you can, place your micro¬ 
computer system in a room without 
rugs. Stay away from Nylon rugs! If 
that is not possible, place an anti-stat¬ 
ic mat in front of your system (where 
you sit), and also get a can of anti¬ 
static spray (the stuff you use to keep 
your clothes from clinging) and apply 
it liberally and as often as needed to 
the rug around your system. Also, of¬ 
fice chairs on rolling rubber wheels 
make dandy generators of static elec¬ 
tricity. They are safe if they roll on an 
anti-static mat, but dangerous to your 
system if they roll onto a rug. 

Also, when working on some of 
the boards in your system (even if only 
to change addressing on a memory 


board), make sure that you do not 
give these boards a dishonorable dis¬ 
charge. Ground yourself out prior to 
yanking any boards from the system. 
Even discharging directly to the chas¬ 
sis of the system is better than 
through one of the computers boards 
(at least the discharge path is most 
likely to go back to the protective 
ground at the wall socket, not to some 
expensive components). 

Confidence and Diagnostic 
Programs 

On a weekly basis I run a set of 
comprehensive diagnostics on my mi¬ 
crocomputer system, just for the con¬ 
fidence I get from knowing that 
everything is still working properly. 
Many diagnostic programs are in the 
public domain (free for the asking 
from user group libraries and remote 
software exchanges). 

However, be aware that there 
are few tests that are really good and 
exhaustive memory tests. Don’t ex¬ 
pect these tests to find anything but 
“dead-duck” RAM failures. The best 
memory test that I have seen (com¬ 
mercial or otherwise) is in the public 
domain SIG/M disks, volume 5: 
MEMDIAG.ASM and MEM- 
DIAG.DOC (you may recognize the 
author’s name). 

Most disk tests are generally 
adequate for simple read/write confi¬ 
dence, but try to find one with lots of 
random seek operations during both 
read and write (head positioners go 
sour here). 

By the way, the so-called head 
cleaner diskettes should not be used 
(unless your floppy disk drive manu¬ 
facturer recommends one, which is 
highly doubtful). They can wear 
down a read/write head by tens of mi¬ 
cro-inches in 30 seconds of use, as 
compared to one year of operation 
with the crappiest diskette you can 
find. Most diskettes cause “self¬ 
cleaning” anyway, and unless you 
have diskettes with visible burn-out 
(i.e., you can see through them), don’t 
worry about it. Read/write heads are 
better left alone, especially the double 
sided type with tiny little spring gim- 
bles that are easily bent — don’t 
tamper! 

A “poor man’s disk test” is the 
nonstop use of the PIP command to 
copy files from one disk drive to an¬ 
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other. Use PIP in a “.SUB” test file, 
and use SUBMIT to re-SUBMIT the 
“.SUB” test file itself (use CON- 
TROL-B to end the “endless” submit 
operation). Try copying a lot of short 
files to perform the most mechanical 
(read/write head load and unload) 
operations possible, in conjunction 
with files scattered all over the disk¬ 
ette. This is usually adequate for a 
confidence test. 

Program Backup and File 
Maintenance 

I cannot stress enough the im¬ 
portance of “backing-up” (copying) 
all programs and data files. The most 
important disks to save as backups 
(and never use) are the original disks 
you purchased for your system. These 
“master” disks are used only once: to 
make a master copy! 

Check to see if the master disks 
are write protected before inserting 
them into your disk drive. Get the 
best floppy disks that money can buy, 
and make three copies of each master 
disk. 

After the copy operation, iden¬ 
tify each disk using the labels sup¬ 
plied; however, mark the labels before 
putting them on disks. Even a slight 
amount of pressure through the disk’s 
jacket will cause damage to the thin 
oxide coating of the internal disk 
itself. 

If you must write over a label al¬ 
ready attached to a disk, use a felt-tip 
pen and apply very little pressure. Do 
not use bail-points or pencils! 

Mark your disks as (1) “Mas¬ 
ter,” (2) “Master Backup,” and (3) 
“Working Copy.” Date the working 
copy for future reference, in order to 
keep track of its use. My WordStar 
program disk gets a real workout, and 
I “retire” these overworked disks to 
the “scratch pile” after six months of 
heavy use. 

Don’t use an eraser to change 
the information on labels. Erasers 
tend to leave particles of abrasive 
rubber to float around the inside of 
the disk jacket. To change a label, 
carefully peel-off the old label and 
stick on a new one. Don’t paste a new 
label over the top of an old one — on 
some floppy disk drives, this changes 
the dimensional characteristics of the 
disk, which may cause data to be re¬ 
corded poorly. 
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File the master disk in a metal 
filing cabinet (or wherever you keep 
important documents), preferably in 
a room at the opposite end of your 
home or office (figuring that only 
half of your house may burn down). 
Do not store disks up high in a closet 
where it may get warm during the 
summer months. 

Keep the “Master Backup” ac¬ 
cessible, but also in a safe place (e.g., 
filing cabinet), and use your “Work¬ 
ing Copy” for doing the things you 
bought a microcomputer to do in the 
first place. 

Why three copies? Well, con¬ 
sider this: you’re working late one 
evening, and zap! Your disk is clob¬ 
bered. Hmmm, that’s strange... So, 
you grab your (only?) available 
backup disk and, a minute later, zap! 
It is wiped out also! Some weird hard¬ 
ware failure got both of them! 

You get the point: with a third 
copy, you still have your “Master” to 
go back to, once you have fixed the 
hardware problem (and not until!). 

Archives are a very important 
part of disaster prevention and recov¬ 
ery. Although floppy disks are not 
cheap, consider your initial invest¬ 
ment (consider the cost of WordStar 
for instance!). Also, consider the 
hours of work that you put into devel¬ 
oping and debugging your program, 
or typing data into your data base, or 
composing paragraphs of your book. 
The retail cost of the floppy disk is a 
tiny fraction of its worth while it con¬ 
tains data. 

To help minimize the cost of 
backing up software, there is a nice 
software package called Squeeze and 
Unsqueeze (actually SQ.COM and 
USQ.COM). The Squeeze and Uns¬ 
queeze programs save as much as 
45% of the disk space occupied by a 
file. You guessed it — the Squeeze 
program squeezes the files on your 
disk by copying them into a 
“squeezed” format, to make room for 
more files on the disk (the originals 
are presumed to be on another disk). 
The Unsqueeze program copies 
“squeezed” files into the regular stor¬ 
age format (which takes up more 
room on the disk, so you would want 
to “unsqueeze” the files to another 
disk that can hold them). 

The Squeeze and Unsqueeze 
programs (SQ.COM and USQ 

Page 54 


.COM) were written by Richard 
Greenlaw and placed in the public do¬ 
main (thanks, Richard). You can find 
them on most RCPMs (Remote 
CP/M Systems). Call mine with your 
modem, and keep trying: CP/M-Net, 
805-527-9321. Richard also wrote a 
program called TYPESQ (type- out 
squeezed files) that lets you uns¬ 
queeze the contents of a text file (doc¬ 
ument, source program or any simple 
ASCII file) quickly for display only 
(very useful for viewing lists of pro¬ 
grams available on RCPM systems, 
since most large lists are in squeezed 
format). Richard also wrote a batch 
processing “parameter list builder” 
called FLS. 

These and many other useful 
CP/M programs are available and 
free for the cost of a phone call. More 
public domain programs for CP/M 
systems are available from two user 
group software libraries (usually for 
the cost of an eight-inch disk plus 
mailing): CPMUG, 1651 Third Ave¬ 
nue, New York NY 10028, and the 
SIG/M, Box 97, Iselin, NJ 08830. 

Here are four useful CP/M 
programs in the public domain: 

CRCK.COM, written by Keith 
Peterson, generates Cyclic Redun¬ 
dancy Check (CRC) numbers for 
validation and verification of files on 
disk. You don’t have to know the spe¬ 
cific details of CRC numbers, just 
that a unique set of numbers is gener¬ 
ated for each file you run with 
CRCK.COM. Before sending a file to 
another system, you run 
CRCK.COM on the file to get this 
unique number. After sending the 
file, the receiver runs CRCK.COM 
on the new copy to see if the unique 
number matches the first one. If the 
files are identical, they will match. 

DU.COM, written by Ward 
Christensen, is a great “fixer- upper” 
for disks whose directory areas are 
scrambled or whose files were erased 
(even disks with which you performed 
an ERA The features of the 

handy Disk Utility are too numerous 
to mention here, but this is program 
you must have for really good system 
maintenance and disaster recovery. 
For further details, refer to the 
CP/M-Net News , June 1981, Num¬ 
ber 6, Volume 1, Issue 6 (available 
from the CP/M-Net RCPM system). 

FILE-XT2.COM, written by 


yours truly, is useful for examining 
the detailed directory information on 
a CP/M 2.2 compatible disk (thanks, 
Kelly — the editors). This utility al¬ 
lows you recover all of the informa¬ 
tion required by CP/M to determine 
the file allocation and attributes of 
the individual files on a CP/M disk. 
This information is absolutely re¬ 
quired (print a hard copy!) if you have 
to fix a scrambled CP/M disk direc¬ 
tory at some later time. 

FINDBAD.COM, written by 
Gene Cotton, will find bad sectors on 
a floppy disk, accumulate the groups 
holding the bad sectors, and write the 
bad group allocations to the disk di¬ 
rectory as a file named [UNUSED] 
.BAD. Since the bad sectors are 
already allocated to a file, CP/M 
cannot use them for good files. I al¬ 
ways use FINDBAD after format¬ 
ting a pile of disks, to save me from 
the grief of bad sector errors when 
I’m working. 

These programs (fully compati¬ 
ble with any floppy disk format using 
CP/M Version 2.2, eight-inch or five- 
inch) form part of my “standard” 
utility set that resides on my day-to- 
day “work disk.” 

Tidiness is Happiness 

A tidy computer is a happy 
computer. You learned this rule first¬ 
hand if you ever assembled your own 
microcomputer (either from 
“scratch” or in kit form), and careful¬ 
ly examined the interconnections of 
power supply wiring, the cabling to 
peripheral devices (printers, disk 
drives, terminal, etc.), looked for 
frayed wires and poor solder connec¬ 
tions, discovered inadequate power 
handling capability, etc. 

As you add additional boards to 
your microcomputer system, the abil¬ 
ity of the power supply to provide the 
necessary power to the additional 
boards may be limited by the voltage 
drop across the wires trying to get 
power to those boards! 

For example, I started out with 
six boards in my crusty old IMSAI 
computer. I added another, then an¬ 
other, and another, and soon I had 
used up most of the available 22 slot 
mother-board connectors and the 
original power supply just couldn’t 
hack it. 

I replaced the power supply 
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with a heavy duty supply (25 
Amp/+ 8 VDC), but still couldn’t 
get enough power into the mother¬ 
board because I used the original wir¬ 
ing. So, I got the heaviest gage wire I 
could find (10 AWG) and rewired the 
entire mother- board. 

Let me tell you a secret about 
IMSAI S-100 mother-boards: wire 
the mother at both ends of the power 
distribution buss lines and use the 
shortest length wire path possible. 
This will guarantee that there is a 
minimum voltage drop not only in the 
cabling to the mother-board, but will 
minimize any voltage drop across the 
mother-board. While rewiring my 
system, I added a small 12 volt incan¬ 
descent panel lamp across the power 
supply +8 VDC filter capacitor. 
Why? Consider that this filter ca¬ 
pacitor is one heck of a storage bat¬ 
tery for a considerable time after 
power is turned off. It may take as 
much as a minute for this capacitor to 
discharge, and during this minute you 
may be yanking or inserting another 
board into the mother-board... and 
zap!! Due to the clever pin assign¬ 
ments of the S-100 buss + 8/ + -16 
power (and just the slightest amount 
of “skew” inserting or removing a 
board), you have “zorched” not only 
that board but probably all the other 
boards in the system! I use the panel 
lamp as a “power safe” indicator. It 
costs less than fifty cents, and can 
save hundreds of dollars in costly re¬ 
pair or replacement. 

Also, make sure that all fuses 
are rated for the power your system is 
using. There are few things more dis¬ 
concerting than to see the printed cir¬ 
cuit board power etch “curled-up” on 
various boards in your system, be¬ 
cause it was not properly “fused.” 

Re-inspect the power wiring 
from time-to-time and look for nicks 
or cuts in the insulation. This reminds 
me of the time I arc-welded my IM¬ 
SAI to the top of my Sanyo Monitor 
— a splendid pyrotechnic display to 
be sure, all due to a tiny nick in the 
-1-8 VDC wiring to the chassis that 
developed from months of inserting 
and removing boards in the mother¬ 
board, and the fact that I had defeat¬ 
ed the 3-wire AC power plug (chassis 
ground return) with one of those 
“handy-dandy” adaptor plugs... 
Argh!! 


Finally, try to minimize conta¬ 
minants from getting into your sys¬ 
tem. Smoking and food (and yes, 
beverages such as beer) will not do 
good things for your system (do as I 
say here, not as I do). Terminals with 
vent holes in the tops of the cabinets 
for cooling pose problems for people 
like me who see the cabinet as a nice 
place to set a cup of coffee, can of 
beer, etc. You can make a beautiful 
corona (ala the “aurora borealis”) by 
spilling the coffee or beer inside the 
terminal. 

A truly fascinating sight, but if 
the “arc’n-mit-shpark’n” doesn’t 
blow your terminal (or microcom¬ 
puter) up, the acid content will rot 
things out, or the carbon content (su¬ 
gar) eventually will short things out. 
Soft drinks are especially bad for ter¬ 
minals and computers! 

If you spill something inside the 
terminal or computer, don't wash it 
out with any kind of solvent other 
than pure distilled water. Let it dry 
thoroughly before applying power 
again. To date, my poor old IMSAI 
has consumed only one beer, and lived 
to tell about it. There was this cherry 
tomato, that (somehow) wound-up 
wedged down inside a power supply 
that months later, phfft... well, you 
get the picture! 

Oh Yes... Recovery! 

Believe it or not, we are usually 
our worst enemy when it comes to 
causing problems with our microcom¬ 
puters. CP/M is a fairly simple oper¬ 
ating system, but there are times 
when we use its simple blind power to 
clobber a disk or two... or three! Re¬ 
member, do not use your master pro¬ 
gram disks and backup data disks — 
with them intact, there is always 
hope. 

However, there are those really 
dumb times (usually at late hours and 
provoked by too many cans of beer) 
that can really blow you into the 
weeds. I remember vividly the time I 
tried to copy 25 master disks for a 
friend, putting the blank disk in drive 
A and the master disk to be copied in 
drive B. Yes, you are right — I turned 
25 master disks into blank disks! 

Sometimes you learn the hard 
way. In such situations, the important 
thing to remember is dont panic! Un¬ 
less there’s a fire inside the chassis, 


don't turn your system off if you need 
to recover important work that is gen¬ 
tly nestled within the RAM of your 
system. It’s usually still there in 
RAM, unless you had a “brown-out” 
or stroke of lightning (I told you how 
to avoid them). The data needs to be 
cajoled out of RAM and stored on 
disk (or tape, or anywhere it can be 
saved). 

When you’re in the middle of a 
WordStar session (or whatever word 
processor you use), and the program 
“crashes,” try this: re-boot your sys¬ 
tem (preferably with a known good 
disk), fire up DDT (the debugging 
program supplied with CP/M) or 
SID (a symbolic debugger from Digi¬ 
tal Research), and start dumping 
memory to the terminal while search¬ 
ing for your edited text. It’s in there 
someplace! 

Note the beginning address of 
the text, and find the end of the text 
and note that also. Then use the DDT 
(or SID) H command to get the sum 
and difference, and note the number 
of pages (256 bytes/page). Now, 
move the whole section down to ad¬ 
dress 100 Hex with the M command, 
leave DDT or SID by typing a CON- 
TROL-Cor the GOP command) and 
use the SAVE command to save the 
total number of pages you noted. 
You may not save all of your work, 
but you may save most of it! 

Also, take advantage of the 
built-in facilities offered with text 
editors such as ED and WordStar. 
Save your current editing session on 
disk frequently (CONTROL-H for 
ED; CONTROL-* and then S for 
WordStar) when working on some¬ 
thing important. Saving while work¬ 
ing will save you from grief later on, 
and takes so little time to do, as com¬ 
pared to retyping the last two hours 
worth of work. 

That’s all for this installment. 
Keep ’em cool, tidy, and fed with pow¬ 
er properly. Get some file and disk 
maintenance utilities from the library 
of public domain software. Don’t 
panic. Use DDT or SID to recover 
data from RAM. Use the saving fea¬ 
ture of your text editor or word pro¬ 
cessor frequently. And keep good 
backups! 0 

CP/M is a registered trademark of Digital Research. 
Wordstar is a trademark of MicroPro International. 
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Brief Looks At CP / M Systems... 


The Alspa ACI Computer 

An inexpensive single-drive system 



We’ve been using two Alspa 
ACI-1 computers in our editorial of¬ 
fice for writing and editing purposes. 
The Alspa ACI-1 is a single-board 
computer tucked underneath a stan¬ 
dard eight-inch floppy disk drive 
(ours each contain a Siemens drive). 
Each unit weighs only twenty lbs. (9” 
wide, 6” high and 18” deep), and lists 
for $1995 (for CP/M, add $150). 
You can attach any standard termi¬ 
nal (we.chose the inexpensive ADDS 
Viewpoint 3A Plus for $550) and the 
computer is ready to use. 

The Alspa is an interesting 
computer because it is the first useful 
single-drive CP/M system that we 
have found. Alspa provides a custom¬ 
ized version of CP/M that lets you 
transfer files from one disk to another 
using only one disk drive. We had not 
previously seen a CP/M system that 
was useful in a single-drive configura¬ 
tion. We were surprised to find our¬ 
selves able to cope with the task of co¬ 
authoring and co- editing text files by 
using two single-drive Alspa comput¬ 
ers that are far less expensive than the 
two double-drive computers we had 
previously used. 

Put aside objections to limited 
disk space and consider these advan¬ 
tages: 

• Your working disk contains the 
word processing program and 
your text files. No need to 
change “logged” disk. 

• Your text file disks (on single 
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density format, for archival 
storage) contain backups of text 
files. 

You can manage text files using 
different working disks for each 
project. 

Two users can share working 
disks, with each working disk 
representing a project such as a 
book, a set of related docu¬ 
ments, or an issue of a maga¬ 
zine. 


are the most recently updated 
ones. Since all updating occurs 
regularly, working disks always 
contain the most recent files. 

Alspa provides a utility that 
combines the DIR and STAT dis¬ 
plays: the D.COM program. Type D 
followed by RETURN, and the sys¬ 
tem displays all files in alphabetical 
order with their sizes (in increments 
of 1024 bytes) and the total amount 
of disk space used and free. You can 
also use the CP/M ambiguous file¬ 
name matching symbols (* and ?) 
with D.COM to display several files 


End confusion about which files 
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and the sum of the space they occupy. 

The Alspa ACI version of 
CP/M includes an FCOPY utility 
that facilitates copying from disk to 
disk. You can use the CP/M ambigu¬ 
ous filename matching symbols with 
FCOPY to copy several files at once, 
or to copy the entire disk. FCOPY 
can read any single-density eight-inch 
disk in the CP/M format, even text 
and data file disks used with other 
CP/M systems. 

Alspa provides a very useful 
FORMAT program (FORM1K- 
.COM on our systems) that automati¬ 
cally creates a system disk and places 
D.COM on the disk. FORMAT lets 
you choose between the Alspa double¬ 
density single-sided format (600K 
per disk), the double-density double 
sided format (1200K per disk), or the 
standard CP/M single-density for¬ 


mat (200K per disk). 

You can also use FORMAT to 
copy system tracks of a system disk to 
another disk that has data on it, with¬ 
out disturbing the data. We use this 
feature to turn a a backup text file 
disk from another CP/M system into 
an Alspa system disk. The text files 
on the disk (placed there by another 
system) were never disturbed and 
were easily copied to other Alspa 
disks. Since FORMAT places the 
D.COM program on the disk to use to 
access its directory, you can use this 
feature to replace an old version of 
CP/M with a newer version. 

Alspa provides the SYSTEM 
utility to configure its serial and par¬ 
allel ports (we have only serial ports 
on our unit, but newer versions have 
an additional parallel port). 

Alspa ACI systems are de¬ 


signed to allow easy interfacing to 
hard disk subsystems, especially the 
Corvus hard disk. Alspa has a version 
of CP/M that controls a Corvus hard 
disk to provide five megabytes 
(5,000K bytes) of on-line storage. 

Alspa’s version of CP/M in¬ 
cludes the “AUTO-BOOT” ability to 
start the Alspa and run a program 
without the use of a terminal. With 
this feature, and space-saving dura¬ 
ble box to hold the computer and disk 
drive, the Alspa is very useful in fac¬ 
tory and control environments. We 
have found the Alspa to be a rugged 
and reliable CP/M system. 

Alspa ACI systems are avail¬ 
able from Alspa Computer, Inc., 300 
Harvey West Blvd., Santa Cruz, CA 
95060 USA (408-429-6000). 0 
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Brief Looks At CP/M Systems... 


The Osborne 01 Portable Computer 

An inexpensive computer for everyone 


The Osborne 01®, at $1795 (in¬ 
cluding software), is the first afforda¬ 
ble portable CP/M computer. 
Dubbed the “Volkswagen” of com¬ 
puters, The Osborne 01 is the first of¬ 
fering from Osborne Computer 
Corporation — the computer compa¬ 
ny founded by the outspoken Dr. 
Adam Osborne, a former columnist 
for InfoWorld and prolific author and 
publisher of computer books. 

The Osborne 01 computer has a 
five-inch screen, a full- size alphanu¬ 
meric typewriter-style keyboard with 
additional calculator-style numeric 
12-key pad, two floppy disk drives, 
one serial RS-232 port, one modem 
port, and one parallel port, in a case 
the size of a portable sewing machine 
that fits under an airline seat and 
weighs under 25 pounds. 

The Osborne 01 is supplied with 
CP/M®, WordStar® for word pro¬ 
cessing, MailMerge® for form letters 
and printing from mailing lists, Su- 
perCalc® for calculating on spread¬ 
sheets, and both CBASIC® and 
MBASIC® for BASIC programming. 

CP/M on the Osborne is en¬ 
hanced with a HELP facility, disk 
COPY and XDIR utilities, and use of 
the “auto-start” feature of CP/M 
that automatically starts programs. 
The Osborne version of CP/M can 
run any CP/M program that can be 
installed for the Osborne 01 display 
screen. 

The Osborne 01 screen is small 
for constant work and for viewing text 


files, and the standard disk drives 
(92K capacity) offer less disk space 
than most CP/M systems. However, 
the computer is so useful and inexpen¬ 
sive that no one complains. We find it 
useful for writing on the road and 
communicating with our office com¬ 
puter by phone. 

Osborne Computer Corp. plans 
to make upgrades available, including 
double-density disk drives that will 
double the amount of storage space 
available on floppy disk. External 
large-screen monitors are available 
from nearly every Osborne dealer. 

Without double-density drives 
you do not have a great amount of 
disk space compared to other, non¬ 
portable (and more expensive) sys¬ 
tems. You have to plan your activities 
properly and use a lot of disks. As a 
stationary desktop computer, the Os¬ 
borne 01 (without an add-on hard 
disk) lacks storage capacity for large 
applications like data base manage¬ 
ment; however, as a portable comput¬ 
er, the Osborne 01 offers complete 
CP/M capabilities at an outstanding 
price. 

Application programs are sup¬ 
plied on separate disks. Each appica- 
tion disk can be used as a system disk 
— the reserved system tracks of the 
disks are used for CP/M. 

The idea is to use drive A as the 
system and application program disk, 
and use drive B as the disk to hold the 
new text files or data files you create 
with that application program. For 


example, to use WordStar, you insert 
your working copy of the system- 
/ WordStar disk in drive A, and insert 
a WordStar text file disk in drive B. 
To use SuperCalc, you should replace 
your system/WordStar disk in drive 
A with a system/SuperCalc disk, and 
replace your text file disk in drive B 
with a SuperCalc data file disk. 

To start using the Osborne 01, 
insert the disk containing the CP/M 
system programs and HELP utility 
into drive A, and follow the directions 
on your screen to press the RETURN 
key. The disk should start the HELP 
program automatically. 

Each disk contains an automat¬ 
ic start-up program — a program 
that runs immediately after you start 
the system with that disk. For exam¬ 
ple, the WordStar disk automatically 
starts WordStar, the SuperCalc disk 
automatically starts SuperCalc, the 
CP/M HELP disk automatically 
starts the HELP facility, and the oth¬ 
er CP/M disk automatically starts 
the XDIR command. (You can turn 
off this feature by renaming or delet¬ 
ing the disk’s AUTOST.COM file.) 

The XDIR utility combines in¬ 
formation from the CP/M built-in 
DIR command (filenames) and infor¬ 
mation from the STAT system pro¬ 
gram (disk space and file sizes) to 
produce an alphabetized list of filen¬ 
ames with their sizes, and a bottom 
line reporting available disk space. 
(The XDIR.COM program is small¬ 
er than STAT.COM). 
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Osborne provides a COPY pro¬ 
gram that combines formatting and 
copying. You can copy an entire disk 
track by track to another disk (auto¬ 
matically formatting the other disk), 
or format a disk without copying. You 
can also execute COPY from one sys¬ 
tem disk, and have it copy the con¬ 
tents of another disk to a third disk 
(automatically formatting the third 
disk). 

You can store only 92K bytes on 
each single density disk. We found 
that we could include the COPY- 
.COM and XDIR.COM programs on 


ames and file sizes (XDIR), and for¬ 
matting or copying entire disks 
(COPY). 

With XDIR.COM you don’t 
need STAT.COM on every disk; with 
COPY.COM, you don’t need PIP- 
.COM on every disk. However, the 
standard PIP.COM is extremely use¬ 
ful for copying single or multiple 
files, or for copying to devices. The 
WordStar disk can still be useful 
without P1P.COM, since WordStar 
can copy files to other disks and can 
send files to the printer. 

The Osborne 01 is designed to 
make anyone familiar with its appli¬ 
cation programs, and lists for $1795 


(including software). Options are 
available (modem, larger external 
video monitor, and battery pack) as 
well as a library of CP/M software on 
Osborne disks. 

The Osborne 01 is sold by deal¬ 
ers internationally. Contact Osborne 
Computer Corp., 26500 Corporate 
Ave., Hayward, CA 94545, USA for 
your local dealer. 0 


CP/M is a registered trademark of Digital Research Inc. 
CBASIC is a registered trademark of Compiler Systems. 

M BASIC is a registered trademark of Microsoft. 

Mail Merge is a registered trademark, and WordStar is a trade¬ 
mark of MicroPro International. 

SuperCalc is a trademark of Sorcim Corp. 

Osborne 01 is a trademark of 0CC (Osborne Computer 
Corp.). 


each application disk to make them 
useful for checking disk size, filen¬ 
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Brief Looks At CP/M Systems... 


The IBM 

Personal Computer 


Big Blue’s version of CP/M-86 



IBM® provides a 16-bit version 
of CP/M® (CP/M-86®) for their new 
Personal Computer (PC). How does 
it differ from the eight-bit version of 
CP/M? 


The obvious changes include a 
command to set the time and date 
(TOD command), a utility that 
copies an entire disk track by track 
(COPYDISK), and a HELP utility 
that displays helpful messages about 
any command. CP/M-86 on the PC 
lets you use function keys to view a 
disk directory or check the free space 
on disk. The system also provides two 
very useful commands, SPEED and 
PROTOCOL, to control nearly every 
aspect of serial data communications 
(using the PC’s serial port). 

The not-so-obvious change is 
the added capabilities of a 16-bit op¬ 
erating system designed for the 8086 
or 8088 processors. 

The advantages over CP/M-80 
(the standard eight bit operating sys¬ 
tem) include the ability to handle the 
more advanced programs that will 
soon be offered for 16-bit systems. 


-Ifiififfiil 
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The IBM PC has a business config¬ 
uration that can support the standard 
CP/M environment (64K) as well as 
grow to handle larger internal mem¬ 
ory requirements (256K to 512K). 

Files on CP/M-86 systems can 
be used in CP/M-80 systems; and 
files on CP/M-80 systems can be 
used with CP/M-86. However, 
CP/M-80 programs cannot be run in 
CP/M-86 systems, nor can CP/M-86 
programs be used in a CP/M-80 sys¬ 
tem. CP/M-80 programs can be al¬ 
tered to work in CP/M-86 systems, 
but they cannot be put to work with¬ 
out some modifications. CP/M-86 
utility programs (“transient com¬ 
mands’’) use the “.CMD” rather than 
“.COM” extension. 

The PROTOCOL and SPEED 
commands let you make baud rate ad¬ 
justments and change communica¬ 
tion protocols. They simplify a 
problem that is traditionally compli¬ 
cated in CP/M and other systems, 
and let you use commands like TYPE 
directly with serial devices. PROTO¬ 
COL lets you select “no protocol” 
(for older or foreign devices), 
XON/XOFF, or ETX/ACK (two 
widely-used protocols). 


You start CP/M on the PC by 
loading the disk in drive A and press¬ 
ing CTRL-ALT-DEL (the CTRL, 
ALT and DEL keys simultaneously). 
CP/M on the PC includes the NEW- 
DISK command to format disks. A 
formatted PC CP/M system disk 
(with no files except the system itself) 
has 141K of free space for utilities 
(“.CMD” files), application pro¬ 
grams and files. 

The IBM PC's monochrome 
display has a higher resolution than 
most personal computer displays (7x9 
dot characters within a 9x 14 dot box). 
With the two disk drives (320K to¬ 
tal), 64K internal memory and mon¬ 
ochrome display, the PC costs $3600. 
CP/M-86 is an additional $250. 

CP/M-86 is also available for 
the IBM Displaywriter. IBM Person¬ 
al Computers and Displaywriters are 
on sale at IBM Product Centers 
throughout the U.S. CP/M-86 for 
the Displaywriter is available directly 
from Digital Research, P.O. Box 579, 
Pacific Grove, CA 93950 USA (408- 
649-3896). 0> 


CP/M is a registered trademark of Digital Research Inc. 
CP/M-86 is a trademark of Digital Research. Inc. 

IBM is a registered trademark of International Business Ma¬ 
chines Corp. 
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MULTIPLE CHOICE 
FOR MULTIPLE USERS. 

CompuPro, the company that pioneered 8/16 bit dual processing for micro¬ 
computers, has now created the 8/16 bit multi-user operating system for the 80s. 



MP/M® 8-16, CompuPro’s proprietary edition of Digital Research’s MP/M 86 V2.0, unleashes the power of 
dual processing for unprecedented multi-user performance. Let different users run different software packages 
at different stations—even mix 8 bit (CP/M 2.2) and 16 bit (MP/M 86) software in the same system, with 62K of 
available RAM per station. As a bonus, all 8 bit programs run under a true 16 bit operating system for maximum 
speed and efficiency. 

Suddenly, other operating systems seem outdated: MP/M 8-16 offers the best of the 8 and 16 bit worlds in 
high performance multi-user environments. 

MP/M 8-16 lists for $1000. System requirements include CompuPro dual processor (CPU 8085/88) based system with appropriate interfacing, memory, disk capabilities, as well as the System 
Support 1 board and optional MPX-1 board. 


Interfacer 4 

Now it only takes one board to handle three of the most needed interface functions: interfacer 4 includes three RS-232C serial ports 
(two of which may be run in either synchronous or asynchronous mode), one full duplex parallel port with attention and strobe, and one pin 
compatible Centronics/Epson parallel printer port. $350, $450 CSC. 


CPU 86187 42E) 

CPU 86/87 delivers ultra-efficient, high speed 16 bit computing. Based on Intel’s 8086 16 bit processor, CPU 86/87 also includes the 
80130 interval timer/interrupt controller and a socket for the 8087 math co-processor (provides number-crunching capabilities rivalling 
many minicomputers). Compatible with both 8 and 16 bit peripherals. $695 (8 MHz operation), $850 CSC (10 MHz operation). Factory 
installed optional 8087 available for $300. Note: Clock speeds limited to 5MHz with 8087. 


Disk 2 


CSC boards are qualified under the Certified System Component high-reliability program (200 hour burn-in, direct exchange program). 

CP/M and MP/M are trademarks of Digital Research; OASIS Is a trademark of Phase 1. MP/M 8-16 is used under license from Digital Research. 


High performance, high speed DMA hard disk controller board set handles up to four disk drives, up to sixteen heads per drive. 
Includes configured version of CP/M® 2.2; also compatible with MP/M, OASIS, CP/M-80, and CP/M-86. $795, $895 CSC. 
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For business, industrial, and scientific computing, 
contact your authorized CompuPro Systems Center. 

Performance, quality, reliability. 

CompuPro division, Godbout Electronics, Oakland Airport, CA 94614-0355 











